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PREFACE 



This is the reference manual for Multileaving Remote Job Entry (MRJE/3000). MRJE/3000 is a 
subsystem of the HP 3 000 computer system, and it provides for the submission of multiple batch job 
streams to remotely -located host computers operating HASP, JES2, JES3, ASP, or RSCS Job Entry 
Subsystems. 

AUDIENCE 



This manual addresses the following types of audience: 

• MRJE/3000 User: The person who accesses the MRJE/3000 subsystem, in either batch or session mode, 
to submit jobs for processing on a host system. 

• The MRJE/3000 Manager: The person who plans MRJE/3000 use and enters MRJE/3000 Manager 
commands to build MRJE/3000 Configuration Files and to monitor the activity of the subsystem. 

• MRJE/3000 Console Operator: The person who operates the HP 3 000 master console and I/O devices 
and any other person authorized to control the communication links between the HP 3 000 and remote 
hosts from a terminal. 



NOTE 



Readers of this manual should be already familiar with the pertinent 
operating characteristics of their host systems. 



ORGANIZATION 

SECTION 1, Introducing MRJE, introduces you to the capabilities, structure and operation MRJE/3000. 

SECTION 2, Planning MRJE Jobs, explains how to prepare job streams for entry to the host using 
MRJE/3000 and to prepare for output from the host. 

SECTION 3, Commands Available to the MRJE User, describes MRJE/3000 commands available to the 
MRJE/3000 User and describes their function and syntax. Access to host console commands is also 
described. 

SECTION 4, Managing MRJE/3000, discusses the management of MRJE/3000, including the 
construction and maintenance of management files, and describes MRJE/3000 Manager commands. 

SECTION 5, Control of the Communications Link, explains the MRJE/3000 commands used to open, 
monitor, and close the HP3000-to-host communications link from the HP3000. 
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PREFACE (continued) 



SECTION 6, MRJE/3000 Troubleshooting and Information Messages, describes several MRJE/3000 
troubleshooting tools, lists information messages with explanations, and lists error messages with 
explanations and recovery procedures. 

The appendices provide information on MRJE/3000 management file configuration, configuration of the 
HP 3 000, and configuration of the host for communication with the HP 3 000. 

APPENDIX A, Configuration File Contents, provides information about MRJE/3000 management file 
configuration. 

APPENDIX B, Installing MRJE/3000 on the HP3000, describes a suggested MRJE/3000 installation 
procedure. 

APPENDIX C, Configuring MPE to Include MRJE/3000, states how to configure MRJE/3000 into the 
MPE I/O system. 

APPENDIX D, Configuring the Host for Communication with MRJE/3000, provides guidelines for 
configuring the host system for communication with MRJE/3000. 

APPENDIX E, Exit Procedure, describes how to develop and install a user -written exit procedure to 
process console special form setup messages. 

APPENDIX F, Printing Output on an HP2680 Laser Printer describes a use of device class LPS and 
Environment Files in ENV2680A.SYS. 



Output Management is the preferred method of printing on an HP Laser Printer. The method described in 
Appendix F continues to be supported for compatibility with previous versions of MRJE/3000. 

APPENDIX G, Glossary, defines terms used throughout this manual. 

APPENDIX H, ASCII/EBCDIC Character Tables, is a set of character conversion tables. 
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RELATED DOCUMENTS 

Refer to these publications for supplemental information: 

• Communicator 5000(5955-1770) 

• MPE V Commands Reference Manual (^202^-90006) 

• MPE Commands Reference Manual (30000-90009) 

• MPE File System Reference Manual (30000-90236) 

• MPE V Intrinsics Reference Manual (22033-90001) 

• MPE Intrinsics Reference MartuaZ(30000-90010) 

• MPE V Utilities Reference Manual (32033-90008) 

• Pascal/3000 Reference Manual (32106-90001) 

• System Utilities Manual (30000-90044) 

• System Operation and Resource Management Reference Manual (32033-90005) 

• System Manager /System Supervisor Manual (30000-90014) 

• Console Operator's Guide (22002-90004) 

• Native Language Support Reference Manual (22i\i-9000\) 

• Synchronous Single Line Controller (SSLC) Installation and Service Manual (30055-90001) 

• HP30010A Intelligent Network Processor (INP) Installation and Service Manual (30010-90001) 

• HP30020A/B Intelligent Network Processor (INP) Installation and Service Manual (HP 30020-90001) 

• Data Communications Handbook (5957-4634) 

• IBM documents for the host operating system, for example, OS/MFT, OSMVT, OS/VS2 (MVS and SVS). 

• IBM documents related to the host job entry system, for example, JES2, JES3, ASP, HASP, and RSCS. 
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NOTATION 

nonitalics 



italics 



[ ] 



{ ) 



DESCRIPTION 

Words in syntax statements which are not in italics must be entered exactly as 
shown. Punctuation characters other than brackets, braces and ellipses must also be 
entered exactly as shown. For example: 

EXIT; 

Words in syntax statements which are in italics denote a parameter which must be 
replaced by a user-supplied variable. For example: 

CLOSE filename 

An element inside brackets in a syntax statement is optional. Several elements 
stacked inside brackets means the user may select any one or none of these elements. 
For example: 



User may select A or B or neither. 



When several elements are stacked within braces in a syntax statement, the user must 
select one of those elements. For example: 



User must select A or B or C. 



A horizontal ellipsis in a syntax statement indicates that a previous element may be 
repeated. For example; 

[ ^itemname] . . . ; 

In addition, vertical and horizontal elHpses may be used in examples to indicate that 
portions of the example have been omitted. 

A shaded delimiter preceding a parameter in a syntax statement indicates that the 
delimiter must be supplied whenever (a) that parameter is included or (b) that 
parameter is omitted and any other parameter which follows is included. For 
example: 

itemaliitemb] [§itemc] 

means that the following are allowed: 

itema 

itema^itemb 
itema ^itemb^itemc 
itema ^ ^itemc 



CONVENTIONS (continued) 



A When necessary for clarity, the symbol A may be used in a syntax statement to 

indicate a required blank or an exact number of blanks. For example: 

SET [{modifier) ]t^ {variable) ; 

underlining When necessary for clarity in an example, user input may be underlined. For 

example: 

NEW NAME? ALPHA 

In addition, brackets, braces or ellipses appearing in syntax or format statements 
which must be entered as shown will be underlined. For example: 

LET var[[subscript]] = Value 

liilHI Shading represents inverse video on the terminal's screen. In addition, it is used to 

emphasize key portions of an example. 



[ ) The symbol [ ) may be used to indicate a key on the terminal's keyboard. For 

example, [RETURN) indicates the carriage return key. 

(CONTROL) c?/?ar Control characters are indicated by (CONTROL) followed by the character. For example, 

(CONTROL) Y means the user presses the control key and the character Y simultaneously. 
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XIX 



The Multileaving Remote Job Entry (MRJE) subsystem of the HP 3 000 runs under the control of the 
Multiprogramming Executive (MPE) operating system. MRJE/3000 gives multiple users of the HP3000 
access to any remotely connected host computer system that is using the HASP II (version 3. 1 or 
subsequent), JES2, JES3, ASP, or RSCS Job Entry Subsystem. Jobs may be submitted from the HP 3 000 via 
the standard input devices (magnetic discs, magnetic tapes, card readers, and terminals); and output from 
the host may be routed to any of the standard HP 3000 output devices (printers, discs, tapes, card punches, 
and terminals). Jobs may be submitted during an interactive session with MRJE/3000 or by means of a 
batch (stream) job. 

In addition to accommodating multiple users, MRJE/3000 provides for an MRJE/3000 Manager who can 
interactively monitor and control job activity. Host console commands can be entered by the Manager 
from any HP terminal. Users may also be given access to one or more host console commands by the 
Manager. 

MRJE/3000 handles a combination of eight logical print and logical punch streams, using a maximum of 
seven logical print streams or seven logical punch streams. MRJE/3000 also handles seven logical card 
reader streams and a command console input/output stream. These streams are all transmitted over the 
same communications line. 

MRJE/3000 can run on suitably configured HP 3 000s (Series II or later) which have at least one 
operational communications controller. Depending on the model of HP 3000, controllers may be 
Synchronous Single Line Controllers (SSLCs) and Intelligent Network Processors (INPs). 

Multiple hosts and multiple communications lines to the same host are supported by MRJE. 
Communications with the host(s) are governed by multileaving protocol and may take place over dial-up 
(switched) and leased lines. Modem speeds of up to 56000 bits per second are supported on appropriate 
communication lines. 

Figure 1-1 shows a generalized MRJE/3000 communications system. 
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Figure 1-1. Elements of a Data Communication System 
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MRJE/3000 FEATURES 

The MRJE/3000 subsystem provides commands for MRJE/3000 Users to: 

• Specify a particular host machine for job processing. 

• Submit jobs for execution on a host system. 

• Specify job output disposition. 

• Display the status of their jobs. 

• Cancel their jobs. 

• Exit MRJE. 

• Execute MPE commands. 

In addition, any user with the MPE System Supervisor (OP) capability can manage MRJE/3000 resources. 
The user MANAGER. SYS should have OP capability. A MRJE/3000 Manager can: 

• Configure the files for MRJE/3000 operation, both required and optional. 

• Display job status for any job being handled by MRJE. 

• Cancel any job being handled by MRJE. 

• Alter the current MRJE/3000 Configuration File. 

• Maintain the MRJE/3000 Job Log File. 



RUNNING MRJE 

Your group and account must have a MAXPRI=CS or higher in order to use MRJE. To execute MRJE, log 
onto the HP 3000 system with the standard HELLO or JOB and then issue the MRJE command from MPE. 
If the subsequent MRJE/3000 output (for example, listings produced by the DISPLAY command) is to be 
routed to a file as well as to $STDLIST, precede the command with a file equation as shown. If the file 
has not already been built, use the FILE command parameters , NEW; SAVE. 

:FILE LISTING=filename [,NEW;SAVE] 
:MRJE 

After the product identification is printed by MRJE/3000, all users can submit jobs to MRJE/3000, check 
job status, and cancel jobs. In addition, the Manager can monitor MRJE/3000 activity and perform other 
supervisory tasks. The Manager might, for example, define a new host machine by building or altering a 
configuration File, cancel users' jobs, or purge unwanted entries from the Job Log File. 
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PLANNING JOB INPUT AND OUTPUT 

A job submitted to the host via MRJE/3000 may use the host application programs, utilities, and 
languages that are available to other remote users of the same host. Jobs are prepared by entering job 
control information, programs, and data into MPE files in card image format (as if they were being 
entered directly to the host on cards). MRJE/3000 builds job streams from the files and transmits the job 
streams to the host system(s). Users may create disc files to receive job output. Preparation of input and 
output files is discussed in Section 2, Planning MRJE/3000 Jobs. 

Submitting Jobs 

Submission of jobs to the host is a two-step process. They must first be submitted to MRJE. MRJE/3000 
then submits them to the host. If the communications link to the host is open, MRJE/3000 transmits jobs 
as they are submitted (subject to MPE control). Otherwise, they are spooled until communications 
between the host and MRJE/3000 have been established. Spooling of job input occurs only if a pseudo 
reader has been spooled. 

The submission of jobs is refused if the psuedo reader is not spooled and the host is offline, or if the pseudo 
reader is busy. 

Jobs are submitted to MRJE/3000 in files. MRJE/3000 assigns a number to each job and displays its 
number at the submitter's terminal. The jobs may subsequently be referred to by this number. 

Transmitting Jobs and Receiving Output 

In order to transmit jobs to the host, the communications line between the HP 3000 and the host must be 
opened. This is done by issuing the distributed console command, MRJECONTROL START, or its 
equivalent. See Section 5, Control of the Communications Link, for further discussion of MRJECONTROL 
commands. 

MRJE/3000 accesses any spooled input files that were created from input files specified in SUBMIT 
commands and transmits the jobs stored in them to the host system. 

The host system then executes the jobs and returns output to the HP 3000 system. The return of output 
depends on factors such as host system execution time and job turn -around time. 

MRJE/3000 receives the output, determines from its Job Log and Directory Files where the output is to 
be sent (for example, to a disc file or to a line printer), and then routes the output to the proper output 
device. 

MRJE/3000 MANAGEMENT FILES 

For each host machine configured into MRJE/3000 by the Manager, logged on as MANAGER. SYS, 
MRJE/3000 creates a set of three files in PUB. SYS: 

• The Configuration File (MRJECON/?). 

• The Job Log File (MRJEJOBft). 
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• The Directory File (MRJEDIRft). 

These files are accessed during MRJE/3000 execution. 

MRJECON, MRJEJOB, and MRJEDIR are the names MRJE/3000 assigns to the set of files created for the 
default host machine. In multiple host environments, MRJE appends the first character of the host 
identification, h above, to the ends of these names to create unique file names. The names can 
subsequently appear in messages to users. 

The Message Catalog File, MRJECAT, is installed as part of the MRJE/3000 product in the group and 
account PUB. SYS. This file contains most of the messages used by the subsystem. 

Other files associated with MRJE can be created by the Manager, logged on as MANAGER. SYS, or by any 
user who can log on to the SYS account in the PUB group. These are: 

• The Stream File (MRJESTRfi). 

• The Message File (MRJEMSG/i). 

• The Output Management File (MRJETABL). 



NOTE 



One Output Management File, usually MRJETABL. PUB. SYS, serves all host 
systems. 

The Stream File is always accessed when an MRJECONTROL START command is issued. The other files 
may be accessed during execution of the subsystem. 



Configuration File 

The Configuration File, MR JECONft. PUB. SYS, contains host machine configuration information. Entries 
exist for the host SIGNON card image, the default input/output devices for MRJE/3000, line 
connect/disconnect times and other information. The MRJE/3000 Manager can alter specific items in 
this file, or rebuild the entire file, if changes occur in the host or HP 3 000 system. The format and 
contents of a Configuration File are described in Appendix A. 

Job Log File 

The Job Log File, MRJEJOB/?. PUB. SYS, contains information about each job submitted. Record items 
include the job number, the job name, the MPE logon ID of the User who submitted the job, the 
destination files specified for the job output (printer, punch, and special forms), the status of the job (if 
and when the job was transmitted or canceled), and, if the job was transmitted, the number assigned to it 
by the host. A sample Job Log File entry is: 
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J0B#=4 J0BNAME=MYJ0B3 USER=PAT.DCA,M 

PRINT="LP" PUNCH="CLPUN" FORMS="BANKFORM" 

TRANSMITTED TO HOST TUE, MAY 23, 1980, 4:06 PM H0ST#=2354 



Directory File 

This file, MRJEDIR/7.PUB.SYS, is an index to entries in the Job Log file. It is used by MRJE/3000 to 
find entries more quickly. It is not accessible to users of MRJE/3000. 

Message Catalog File 

This file, MRJECAT. PUB.SYS, contains most of the messages that MRJE/3000 displays for the Console 
Operator, the MRJE/3000 Manager, and the User. The Message Catalog file is created when the 
subsystem is installed. Modify the Message Catalog File in those environments where users do not speak 
English . 



CAUTION 



If the Message Catalog is modified, remember to include any message 
parameters in the same sequence as was done in the original file. 



Stream File 

The Stream File, MRJESTR/?. PUB.SYS, is always used whenever an MRJECONTROL START command is 
issued. It should be created by MANAGER. SYS, but may be created by any user with access to the PUB 
group of the SYS account. Security for this file should be restricted to MANAGER. SYS by using the 
MPE command ALTSEC, as described in the MPE Commands Reference Manual. The structure of this 
file is the same as for any stream file. The contents of a Stream File, MRJESTRft.PUB.SYS, must issue 
RUN MRJEMON.PUB.SYS, the MRJE/3000 monitor. A sample Stream File is included with the 
description of MRJECONTROL START in Section 5 , Control of the Communications Link. 

Message File 

The Message File is used to receive host console messages, output messages from the host system, and a 
performance measurement data record which contains information about output data received. The 
Message File may be either an output system file, such as SSTDLIST, or an actual file. If the Message 
File is an actual file, MRJEMSGft.PUB.SYS, then it should be created by MANAGER. SYS, and access to 
it should be limited to its creator. Use the ALTSEC command, as described in the MPE Commands 
Reference Manual. If the Message File is not an actual file, then a file equation must be in 
MR JESTR/7 . PUB . SYS . This is an example for a default host : 

:FILE MRJEMSG=$STDLIST 

This statement directs all messages to SSTDLIST. Section 4, Managing MRJE/3000, describes the 
Message File. This file is optional. If it is absent all messages intended for it are lost. 
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NOTE 



Do not confuse the Message File, MRJEMSGA, with the Message Catalog File, 
MRJECAT.PUB.SYS. 



Output Management File 

MRJE/3000 interprets all form mounting instructions from the host as a directive to route output to a 
destination as specified by an entry. One file, usually MRJETABL.PUB.SYS, is used to route output from 
all configured hosts systems to destination devices. Each entry is composed of a fixed -length 
eight -character FORMID, followed by parameter specifications permitted for a FILE command in MPE. 
If an MRJETABL file is absent, then special forms output is processed using Configuration File values. 

FORMID references, such as in SUBMIT command parameters and Configuration File items, are delimited 
by single quotation marksjfi. For example. 



SUBMIT MYJOB;PRINT=|KENS 

causes all print streams except for special forms to be sent to the specification indicated by the KENS 
entry. If the Configuration File item 20, is 

20. PRINT OUTPUT DEVICE=|STD.| 

then any print output, except for special forms, is sent to the specification indicated by theSTD. entry. 

See Output Management in Section 4, Managing MRJE/3000. 
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MRJE/3000 ON A HIGH SPEED COMMUNICATION LINE 

MRJE/3000 can communicate with a host system at 56000 bits-per-second (56Kb). When an HP2680 
laser printer is connected to an HP 3 000, such as in an HP2685 Model 40 Print Station, you can have a 
very cost-effective remote print station for an IBM plug compatible host system that operates in a 
bisynchronous (BSC) network. 

An HP3000 operating at 56Kb line speed must include: 

• A Bell DDS communication line configured at 56Kb, or a local 4 -wire circuit. 

• An HP 3 00 2 OB Intelligent Network Processor (INP) 

• An HP30221D (30221-60010) INP cable with a V. 35 hood 

• A Bell 500B Data Service Unit (DSU) modem or its equivalent, such as GTE L500A DSU as was used in 
testing. 

• Multileaving buffers should be as large as possible to obtain performance benefits. 

When operating at a high line speed you should consult with host system operations. Also, configure two 
printer streams for better subsystem performance at this speed. 



1-J 



SECTION 




When preparing jobs for a host, an MRJE/3000 User must consider host system characteristics, such as the 
type of Job Entry Subsystem and languages supported, as well as the HP 3000 resources configured for 
MRJE/3000. Many host system characteristics are hsted in the Configuration File. Consult the 
MRJE/3000 Manager or the host system manager for others. The contents of the Configuration File can 
be examined using the MRJE/3000 DISPLAY command. Section 3, Commands Available to the 
MRJE/3000 User, describes the DISPLAY command. The Configuration File is described in Appendix A. 

JOB INPUT 



Job input submitted to a host using a card reader normally consists of individual jobs composed of Job 
Control Language (JCL) cards, executable programs (also on cards), and data cards. The JCL, programs, 
and data are concatenated to form a job stream. 

Construct jobs using MRJE/3000 as you would for direct submission to the host using a card reader. 
However, input with MRJE/3000 is in card images instead of physical cards. Each card image is a record 
that is 80 columns wide. These records are commonly combined into. MPE files by the user; the files can 
then be submitted to MRJE/3000 for processing. 

In the simplest case, a job stream is created from a single input file; in more complicated cases, a stream 
file is built from several files. MRJE/3000 concatenates your files into a single job stream, identifies the 
individual jobs within that stream, and transmits the jobs to the host one by one. They may be 
interleaved with jobs from other job streams as they are transmitted. 

MRJE/3000 accepts input from up to three levels of card image files: 

• Infiles 

• Level -one FD files 

• Level-two FD files 

Infiles are specifically named in a SUBMIT command, while FD files are referenced indirectly by means 
of a card image pointer from an infile or another FD file. Only two levels of indirect file reference are 
permitted. A level -two FD file may not point to another file. Section 3, Commands Available to the 
MRJE/3000 User, describes the SUBMIT command. 

Figure 2-1 illustrates the relationships among several card image files that have been merged into a single 
job stream. The names of the infiles were indicated by the user when submitting the job. First -level FD 
files, RED and BLUE, were specified indirectly by means of records, card images, contained in infile A. 
Two records within RED point to the two level -two files. 

When MRJE/3000 processes a SUBMIT command, it opens each infile named directly in the command, 
and each FD file as it is referenced. Those files specified by an actual file designator are opened with the 
MPE semi-exclusive and read-only file restrictions. All others are opened with the MPE 
read-only/exclusive restrictions. Each file remains open until all of its records have been processed, at 
which time it is immediately closed. 
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Infiies 

Infiles may contain complete or partial jobs. Infiies may contain ##FD cards that point to level-one or 
level-two FD cards. It is possible for an infile to consist solely of ##FD cards. An infile and any FD files 
must form complete jobs. An infile may be transmitted in transparent mode; however, MRJE/3000 
Manager (OP) capability is required to do this. Its purpose is to allow transmission of host system JOB 
cards as data. This means that such jobs are not be entered into the Job Log File of the subsystem. An 
infile may also be transmitted without translation. Section 3, Commands Available to the MRJE/3000 
User, describes the SUBMIT command. Appendix B, Installing MRJE/3000 on the HP 3000, shows some 
sample input files. 

FD Files 

FD files are similar to infiies in that they may contain the same kind of information and are constructed 
in the same way. FD files may be transmitted transparently, as well as without translation. However, 
they are referenced directly by means of ##FD cards contained within the infiies. (See Figure 2-1.) 

Files may not be nested to more than two levels. In other words, one file may reference another, which 
may itself reference another, but the third file may not reference any file. For example, file A in Figure 
2-1 contains an ##FD card pointing to file RED; file RED has ##FD cards pointing to files WHITE and 
CLEAR. The second -level files, WHITE and CLEAR, can not reference any other files. 

FD files may reference infiies; however, the same restrictions on levels of FD file nesting still apply. 
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INFILES 
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CARD C2 



CARDC3 
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Infiles A and X are submitted to DSN/MRJE in tine SUBMIT 
connmand. Example: SUBMIT A,X 



Card images will be transmitted to the host in this order 




CARD X6= 



TCARD R1 



r CARD A5l 



JOB STREAM 



Figure 2-1. Relationship Among Files in a Job Stream. 



2-3 



Planning MRJE/3000 Jobs 



##FD cards have the format: 



Syntax 



##FD filename \ (N [OTRANSLATE] [ ,T[RANSPARENT] ] ) ] 
IFIfi-u jttename ^ (t[ranSPARENT] [,N[OTRANSLATE] ] ) J 



[comment] 



Parameters 

##FD 
filename 

NOTRANSLATE 

TRANSPARENT 



comment 



File Definition. ##FD must occupy columns 1 through 4. 

An MPE filer eference. Files referenced by ##FD may not be nested more 
than two levels. 

No translation requests that the FD file be transmitted without translation. 
Refer to the SUBMIT command for more information about translation. 

Transparent transmission requests that all JOB cards in the FD file be 
passed to the host as data. As a result, all the JOB cards are ignored by 
MRJE/3000. If the (T) parameter is included, the proper JCL must still be 
included so the host also treats the JOB cards as data. Use the proper DD 
card. 

A character string. The comment becomes a prompting string when the 
filename is $STDIN. 



Examples 

##FD FILEB(T) **Ignore JOB cards in FILES** 

##FD C (N,T) **Do not translate C; ignore JOB cards** 

If a file is built that requests input from $STDIN or $STDINX, the optional comment field on the ##FD 
card should be used to identify the type of input that is expected. Then, when the job input stream is 
constructed, the comment is printed at the user's terminal ahead of the standard MRJE/3000 message: 
ENTER INPUT ENDING WITH "MRJEOD". For example, if the m/i7e DATA 1 contains the record 

##FD $STDIN This input is for file DATA1 . 

the following appears at the terminal: 

This input is for file DATA1 . 
ENTER INPUT ENDING WITH "MRJEOD" 
> 
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Host System Job Control 

MRJE/3000 does not check a job stream for conformity to all host job stream criteria before 
transmission. It does scan all input files for /*SIGNOFF cards and prints a warning message. The card is 
not transmitted to the host. 

MRJE/3000 requires at least one JOB card whenever a SUBMIT command is issued. If the 
TRANSPARENT parameter is omitted from an infile reference, or from an FD card image, MRJE/3000 
recognizes all JOB cards contained in the referenced file as job delimiters, not data. 

Host system PRIORITY cards have no effect on the host when associated with the second or subsequent 
job in a job stream. Figure 2-2 shows two jobs are submitted to MRJE/3000 together. MRJE/3000 
merges infile A with FD file RED. The first priority card has the desired effect on JOBl. The second 
priority card is transmitted to the host as part of JOBl and therefore does not influence JOB2. 

When priorities are important, each job should be submitted to MRJE/3000 separately. 






/ 

^ 






<p 






// -- / 



INFILE A 



• • 



FD FILE 
RED 




JOB STREAM 



147038-03 



• • • 






#.... 




I 



J0B1 JOB 2 

(?) THIS CARD TRANSMITTED AS VALID CONTROL CARD 

@ THIS CARD TRANSMITTED AS PART OF JOBl AND THUS 
HAS NO EFFECT ON J0B2. 



Figure 2-2. Priority Card to Job Stream Relationship 
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Input File Libraries 

The job streaming feature of MRJE/3000 allows you to construct jobs from job control cards, programs, 
and data that already exist in disc files. You can create libraries of job modules that can be assembled 
into a variety of different jobs. 

It is up to the MRJE/3000 user to ensure that infiles and FD files submitted together constitute a valid 
job according to host system requirements. 
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JOB OUTPUT 

MRJE/3000 uses these criteria to determine the final destination of output for each data set received 
from the host: 

• Is the output solicited or unsolicited. 

• If solicited, did the user specify an output destination when the job was submitted. The SUBMIT 
command described in Section 3, Commands Available to the MRJE/3000 User, is used to specify a job 
output destination. 

• Is Output Management in effect. MRJE/3000 uses the output routing table, usually 
MRJETABL. PUB.SYS, to identify output destinations. Output Management is described in Section 4, 
Managing MRJE/3000. 

• What are the default output dispositions for solicited and unsolicited output as defined in the 
MRJE/3000 Configuration file, MRJECON/?. PUB.SYS. 

• Did the user route output to a special form with the JCL. 
This hierarchy resolves any contradictions in destination: 



SUBMIT Parameters 
ooerride 
JCL Special Forms Routing 
which ooerride 
MRJETABL and MRJECON/? Default Values 



Figure 2-3. Job Output Destination Control Hierarchy 

Job output can be routed to a disc file or to any output device by designating the output files in the 
SUBMIT command. Predefined output routing may take place to files designated whenever the 
MRJE/3000 monitor is started. All files can be formatted for print, punch, and special forms data. 



Record Sizes 

Record sizes should be: 

• REC=-132, ,F,ASCII;CCTL — for print and special forms print files. 
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NOTE 



If printer output is to an HP3000 disc file, then you must specify a record 
width, a recsize parameter of 1 3 3 bytes here, great enough for the carriage 
control character. This can also be stated as 

... REC=-133,,F, ASCII ;NOCCTL ... 

in a FILE or BUILD statement. The maximum recsize value supported for 
a host is 2 5 5 bytes. 



• REC=-80, ,F,ASCII;NOCCTL -- for punch and special forms punch files. 

Specify record sizes at least as great as the record width of the MRJE/3000 output device configured on 
the host. Output file specifications are explained by the SUBMIT command description, in Section 3 
Commands Available to the MRJE/3000 User. 



NOTE 



If a SUBMIT command names a disc output file, the file must be built with 
sufficient extents allocated. MRJE/3000 does not allocate additional 
extents if the need for them arises, although it does notify the system 
operator when the limits of a file have been reached. 

When MRJE/3000 receives job output from the host, the output file is opened with the default 
specification of append-only access and the output is written to it. Output sent to spooled output devices 
is owned by the user and account of the submitter. Sometimes output is not sent to the destination 
specified by the user, but ends up going to a destination for unsolicited output. If this happens, check 
with the MRJE/3000 Manager or the HP 3 000 system operator. MRJE/3000 may not recognize the 
output from your job. 

Kinds of Job Output 

A job submitted through MRJE/3000 to a host system can produce these kinds of job output: 

• Printer Output 

• Punch Output 

• Special Forms Output 

Printer and punch output without special forms uses a standard form. A standard form is usually 
identified as STD . by a host. Special forms output can apply to printer and punch output. Special forms 
are usually identified as something other than STD. by a host. Special forms can apply to printer and 
punch output. 

FORMIDs, entries into MRJETABL, can be used in SUBMIT command PRINT, PUNCH, and FORMS 

parameters, as well as in Configuration File items 20-35. Items 20 and 28 of the Configuration File 
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identify the default printer and punch output devices for solicited output. Items 21-27 are the 
unsolicited output devices for printers 1-7. Items 29-35 are the unsolicited output devices for punches 

1-7. 

Carriage Control Translation 

The host normally sends carriage control information for printers with standard paper or special forms. 
Output for a card punch does not have carriage control information. Table 2-1 describes how 
MRJE/3000 translates host system carriage control information into carriage control characters. 
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Table 2-1. Host - HP3000 Carriage Controls 



HOST SYSTEM CONTROL 



Skip n spaces immediately, where n < 3 



Skip immediately to channel nn, where nn < 1 3 



Skip n lines after printing, where n < 3 



HP 3 000 CONTROL CODE 
AND EXPLANTATION 



Volnn {nn < 3) 

A %101 sent before a %lnn sets up an 
immediate skip. 



%61 (channel 1, page eject), or 
%2>nn (channel nn, where 2 < nn < 12) 

A %101 sent before a %61 or %3nn sets up an 
immediate skip. 



Skip to channel nn after printing, where 
rttt< 13 



Suppress space. 



All other host system control codes. 



Volnn (nn < 3) 

A %100 sent before a Volnn sets up skip after 
printing. 



%61 (channel 1, page eject), or 
%3nn (channel nn, where 1 < nn < 12) 

A %100 sent before a %61 or %3nrt sets up a 
skip after printing. 



%53 



Single space 



Output File Naming 

MRJE/3000 usually assigns the jobname as the name of the output file. All special characters, and any 
leading numeric character in a jobname is replaced by an X character. 

A default output file is named X by MRJE/3000 when it fails to decode a banner. Configuration File 
items 1 1 and 13 specify where job names are to begin in print and punch banners. These must be set 
correctly. 

Overriding the Output File Naming Convention 

Using the lookup table MRJETABL explained in Section 4, Managing MRJE/3000, a system administrator 
can designate alternate names for output files overriding the filename used by MRJE. 

EBCDIC to ASCII Translation 

In general, output is translated from EBCDIC to ASCII according to the specification in MRJE/3000 
Configuration File entry #38 (Language ID for data translation). MRJE/3000 uses the IN print chain for 
a default EBCDIC to ASCII translation code. 
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Data translation is not done when: 

• Output was solicited for which a user specified NOTRANSLATE in the SUBMIT command. 

• Output was unsolicited and is going to a BINARY disc file. 

Output Routing with Output Management 

Output Management is a mechanism for routing output to a final destination based upon instructions sent 
by the host system to the remote system to control operation of the remote print devices. MRJE/3000 
interprets an instruction from the host to mount a special form as a directive to route output to the 
destination file FORM ID. A FORMID is the name of the special form. The output file characteristics for 
each FORMID are described in MRJET ABL. PUB. SYS. MRJE/3000 uses this table to map from forms as 
understood by the host to files as understood by the HP 3 000. 

Output Management can be activated by the system administrator by: 

• First, setting MRJECONft items 20-35 (default output disposition) to the name of the default form as 
configured on the host. This entry must be delimited by single quotes ( ' ). If the host standard form 
identification includes a period ( . ), then the period must be included in the Configuration File entry. 
Periods,or any alphanumeric or IBM national character (#, $ or %) may be used. For example, if 
the default standard form configured on the host is "STD." then Configuration File item 20 should be 
set as follows: 

20. PRINT OUTPUT DEVICE='STD. ' 
A similar entry should be made for each output device configured into the MPE I/O system. 

• Second, build MRJETABL. PUB.SYS using a text editor such as EDITOR or TDP. This file must contain 
entries' for any standard form identified in the MRJECON/i file for all solicited and unsolicited output 
as well as entries for all "special" form identifiers to be supported on the remote. The file records are 
used as file equation specifications to identify output destinations for all standard and special forms. 
Additional information on MRJETABL is available in Output Management in Section 4, Managing 
MRJE/3000. 



Special Forms Processing 

When MRJE/3000 processes special forms with Output Management, a FORMID identifies a destination 
file. See Output Routing with Output Management. Additional information on Output Management is 
available in Section 4, Managing MRJE/3000. 

MRJE/3000 processes special forms without Output Management as follows: Whenever special forms 
output destined for printers is received from the host system, the HP 3 000 console operator is prompted to 
mount the required special form on the printer. After the form has been mounted, MPE writes the 
output file to the printer. This is true for both spooled and unspooled {hot) printers. Use hot printers 
with caution, because data in transition may be lost. 

Special forms can be designated using JCL commands in the user's job file to route output data sets to 
unique forms. 
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Example 



//EXAMPLE JOB (ACCOUNT) , PROGRAMMER 
//STEP EXEC PGM=TEST2680 
//MAINOUT DD SYSOUT=(A, ,F001 ) 
//SECOUT DD SYSOUT=(A,,F002) 



In this example, the output for MAINOUT is printed on the special form F001. The output for SECOUT 
is nrinted on snp.r.ial form Fnno 



is printed on special form F002. 



NOTE 



To route output to special forms, the host system must be configured to 
AUTOMATIC forms mode for each printer. In addition, the output class must 
be set to one for which output is not held on the host for post processing 
(JES2 $x parameter). Typically, this is true of CLASS A. MRJE/3000 
supports special forms processing for both print and punch output. 

If you submit several jobs to a host with one SUBMIT command, any alternate output destinations in 
PRINT, PUNCH, or FORMS parameters override JCL specifications. Section 3, Commands Available to the 
MRJE/3000 User explains the SUBMIT command. 

Printing on an HP Laser Printer 

Routing output to an HP Laser Printer is described in Output Management in Section 4 Managing 
MRJE/3000. Appendix F, Printing Output on an HP 2680 A describes the use of device class' LPS on an 

Output Routing to Message Files 

To route output to an MPE Message File specify the NOLOCK access option in the MRJETABL file 
equation record. This entry in MRJETABL . PUB. SYS denotes a Message File: 

message ;code=msg;nolock 

To route all unsolicited output for printer 2 to this message file the MRJE/3000 Configuration File item 
#22 should be set to the following: 

Unsolicited Print Disposition, Printer 2 = 'MESSAGE' 



Routing Job Output to Pre-Deflned Files 

An MRJE/3000 user can route output to a configured device class or logical device number, or to an 
actual disc file. Output from a job may also be routed to a specific destination, such as a printer with an 
output priority below the outfence, or to an HP Laser Printer with a specific environment file, or to a 
tape with a particular blocking factor. Specific routing requires cooperation between the user who 
submits a job and the administrator of the system. 
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A user must specify a FORMID in a SUBMIT command output parameter: 

SUBMIT ;PHlHT='formid.';PmCH=yormid,"iFORM=yormid.' 

A jormid. value is an index into MRJETABL. A corresponding formid. entry must be in MRJETABL. See 
Output Management in Section 4, Managing MRJE/3000. 

Routing Default Output to Unsolicited Devices 

To route default output from a job to an unsolicited output device, set PRINT=0, PUNCH=0 or FORMS=0 
in the SUBMIT command. This supersedes default output and special form disposition, and routes output 
to one of the unsolicited output disposition device classes, devices, or FORMIDs. 

To submit a job with printer output to be sent to its default output device, use: 

SUBMIT infile 

This identifies the printer output device from configuration output file item 20 as the printer output 
device. 

To submit a job with printer output to be sent to the unsolicited printer output devices use: 

SUBMIT infite;PRlHT=0 

This identifies Configuration File items 21 through 27, unsolicited print disposition for printers 1 through 
7, as the output devices for printer data streams 1 through 7. If FORMS=0 in a SUBMIT command, then 
unsolicited output is sent to the destination identified in items 21 through 27 also. 

If PUNCH=0 in a SUBMIT command, then unsolicited output is sent to the destination identified in items 
29 through 35 of the Configuration File. 

You can alter Configuration File items 20 and 28, default printer and punch output disposition, and to set 
these values to zero. Then all default output would be sent to the unsolicited output destination devices. 

The customary use of unsolicited output devices continues to remain in force, so that unidentified job 
output continues to be routed to unsolicited output devices. 



CAUTION 



Configuration file items 21-27 and 29-35, the unsolicited output devices, 
should always be set to legitimate values such as output device classes, 
logical device numbers, pre-defined files. Form IDs, or Global File 
statements. 

These items should never be set to 0. If these values are set to then job 
output for these devices is lost. 

For additional information on Output Routing consult Output Management in Section 4, Managing 
MRJE/3000. 
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Unsolicited Output Device Routing 

A user can route output from jobs not submitted using MRJE/3000 to unsolicited output devices. Use the 
JCL appropriate to the host system. Specify an output class in either the MSGCLASS parameter of a JOB 
card or the SYSOUT parameter of DD card associated with a printer or punch stream. For example, if the 
output class for printer 3 is K use the following: 

//REROUTE JOB ... MSGCLASS=K . . . 

or 

If DD SYSOUT=K . . . 

For additional information on Output Routing see Output Management in Section 4, Managing 
MRJE/3000. 
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Global File Statements 

Global File Statements can be used to direct output when a job is submitted. 



NOTE 



Global File Statements are superseded by Output Management. 

Global File Statements require: 

• A FILE statement in an MRJESTRft file. 

• A Reference from a SUBMIT command using the formaldesignator preceded by an exclamation mark 
(1) in a PRINT, PUNCH, or FORMS parameter. 



NOTE 



The length of the formaldesignator reference is limited to seven characters. 



Assume these statement are in MRJESTR. PUB. SYS. 



FILE HOLDLP;DEV=LPJ 
FILE LARGEREF;DEV=LP 
FILE X=X,OLD 



And a User enters: 

SUBMIT INFILE;PRINT=iHOLDLP 



SUBMIT AJOB;PRINT=|lX 

The first SUBMIT command directs all print output for its job to file HOLDLP. It specifies device class 
LP with an output priority of 1 . The second SUBMIT command directs all print output for its job to disc 
file X. PUB. SYS, which must already exist. 

No use can be made of the file statement LARGEREF from a SUBMIT command, because it has an eight 
character formaldesignator. 
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COMMANDS AVAILABLE 
TO THE MRJE/3000 USER 



SECTION 



This section describes how to use MRJE/3000 User commands for planning and submitting jobs. 

MRJE/3000 user commands are summarized in Table 3-1. In addition to those listed, the User may enter 
one or more host system console commands, depending on how the Configuration File for a given machine 
has been built. For more about console commands, refer to Host Console Commands at the end of this 
section. 



MRJE/3000 USER COMMANDS 



Before entering any User command, log onto the HP 3000 system and initiate MRJE/3000 execution with 
the MRJE command from MPE. Table 3-1 summarizes commands available to the MRJE/3000 User. 
MRJE/3000 User commands are described in alphabetic order. 
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Table 3-1. Summary of MRJE/3000 User Commands 



COMMAND 



CANCEL JOB IjobnameS 
[Jobtist) 



DISPLAY 



HOST 

JOBLOG 

STATUS 
CONFIG 



'Jobi ^ 

yjobnameS 

^3 jobtist) 

( yitem# \ 
\yitemtistf 



EXIT 



HELP [conrnand name] 



HOST [hostid] 



host console command 



SUBMIT in file [{options)] & 

... [in file [{options)] ] & 

[; READER = pseudo reader] & 

[;PRINT = [^]fileref[{N)]] & 

[; PUNCH = [r]fileref[{N)]] & 
[;FORMS = [\]fileref[{N)]] 

options = J^I^Jj 

N = NOTRANSLATE 
T = TRANSPARENT 



& 



FUNCTION 



Cancels one or more of the User's jobs 



Displays ID of current host, status of User's jobs, 
line status (open or closed), and information about 
host machine configuration. 



Terminates MRJE/3000 and returns control to 
MPE. 



Provides a means for Users and Managers of 
MRJE/3000 to obtain brief instructions about how 
to use the subsystem commands. 



Specifies the host system to be referenced by 
subsequent commands. 

A HASP, JES2, JES3, ASP, or RSCS command that 
usually generates output on SSTDLIST. 



Enters a job for transmission to the current host. 



An ampersand ( & ) is used at the end of a 
command string to continue it to another input 
line. 



The jobif, jobname, joblist, item^, and itemlist parameters are described in the Glossary. 
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Cancels one or more jobs. 



Syntax 




Discussion 

The CANCEL command is used to cancel jobs that have been submitted for processing on the host system. 
For jobs not yet transmitted to the host, CANCEL deletes the specified job number, name, or list from the 
reader spool file and marks the corresponding entry in the Job Log File as cancelled. If the job has been 
transmitted and the host system is on-line when this command is issued, a cancellation command is sent to 
the host system and the Job Log File entry is marked as cancelled. If the job has been transmitted but the 
host system is off-line, the Job Log File entry is marked as cancelled; any output from the job that is 
received by MRJE/3000 when the communications line is re-opened is discarded. 



NOTE 



This command should not be used with an RSCS job entry system. 



Parameters 

JOBS 
job# 



Optional parameter, provided for consistency with the DISPLAY command. 
Omitting JOBS has no effect. 

The number MRJE/3000 assigned to the User's job upon submission to 
MRJE. 



jobname 
joblist 



The name on a JOB card in the User's input files. 
A list of job names and/or job numbers. 



The joi>#, jobname and joblist are described in the Glossary. 



Using Cancel 



Since the CANCEL command always references the files that were created for the current host system, 
you should issue a HOST command beforehand. This assures access to the proper Job Log File. 
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After the CANCEL command has been issued, MRJE/3000 displays the status of each specified job and 
requests confirmation that each job is to be cancelled. A literal YES confirms the cancellation request, 
while any other response (including W} causes the command to be ignored. Although a job may be referred 
to by its name or by its number, its number is preferable because it defines a unique job and results in a 
faster response. If a User specifies a job name for cancellation and more than one job with the same name 
has been submitted, MRJE/3000 prints: 

jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY OF JOBS WITH 
THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 

The message is followed by a list of the User's jobs with the name and their assigned job numbers. No 
cancellation occurs even though all instances of the job belong to the User. You should cancel jobs by 
jo&#, job number. 

Example 

In the following example, two jobs are cancelled. The HOST command has been entered first to be certain 
all commands reference the correct set of files. 

tMRJE 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

USER CAPABILITY IN EFFECT 

#HOST P 

PLMS IS THE CURRENT HOST MACHINE 

#CANCEL 2,4 

--J0B#=2 J0BNAME=TEST2 USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
VERIFY CANCEL WITH "YES" 

ill 

SPOOL FILE DELETED 

J0B#2 CANCELED 

--J0B#=4 J0BNAME=TEST4 USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
VERIFY CANCEL WITH "YES" 

III 

SPOOL FILE DELETED 

J0B#4 CANCELED 

The next example illustrates the execution of the CANCEL command when jobs exist with duplicate 
names: 

#CANC€:L JOB TEST 

TEST: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 
OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 
--J0B#=11 JOBNAME=TEST USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
--JOB#=20 JOBNAME=TEST USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
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This example shows the cancellation of a job already sent to the host system. The communications link is 
currently open: 

#CANCEL JOB 3 

--J0B#=3 J0BNAME=MYJ0B2 USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

TRANSMITTED TO HOST FRI, JUN 15, 1984, 3:20 PM HOST#=2018 
VERIFY CANCEL WITH "YES" 

mi 

$CJ2018, 2018 CANCEL COMMAND WILL BE SENT TO HOST 
$15.35.40 JOB 2018 ON RM.PR2 PRIO 9 PURGE 

The last Hne of the example is a message from the host system in response to the $CJ2018 command that 
was sent. 
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Displays job and system information. 



Syntax 





■ H[OST] 






rjob# ] 






J[OBLOG] ^,jobname> 




D[ISPLAY] 


[, joblistj 
S[TATUS] 

C[ONFIG] /'f^^'"f. \ 
*■ ^ \,itemlist/ 





Discussion 

The DISPLAY command is used to display the name of the current host system, information about active 
and inactive jobs in the Job Log File, the status of the communications line to the host system, or the 
contents of the Configuration File for the current host system. 



Use [CONTROLl Y in a session to halt the display of jobs and Configuration File entries. 
If no parameters are used, then the JOBLOG options is assumed. 



Parameters 

HOST 
JOBLOG 



Lists the current host system. This system is used by every SUBMIT, 
DISPLAY, or CANCEL command until the User issues the HOST command 
and selects another host system. 

Displays information about jobs that were submitted. One of the three 
parameters, job^, jobname or joblist must be specified. Use joi># if possible, 
because it identifies a specific job and using it results in faster processing. 
This is the default parameter. 



NOTE 



This parameter should not be used with an 
RSCS job entry system. A job will always be 
identified as WAITING TRANSMISSION TO 
HOST because RSCS does not acknowledge 
that a data set has been received. Use a host 
console command to inquire about the status 
of a job. 



STATUS 



Reports whether the communications line to the current host system is open 
or closed. 



3-6 



DISPLAY 



CONFIG Lists the contents of the Configuration File for the current host system. If 

the User includes item numbers, only the entries identified by the numbers 
are displayed. 

Item 4, Host Signon Card Image, is displayed only to MRJE/3000 Managers. 

Item numbers are entries in the Configuration File. Appendix A. 
Configuration File Contents describes and explains these items. 

The ;oi>#, jobname, joblist, item.§ and itemlist parameters are described in the Glossary. 

Using Display 

The DISPLAY command always references the set of MRJE/3000 files that were created for the current 
host system. To verify the identity of the current host system, use a DISPLAY HOST command before 
issuing any other commands which affects any files. 

A User may only display jobs owned by the user. If the User specifies a job name in the JOBLOG 
parameter and it is not a unique name, only those instances of that job which belong to the User are 
displayed. 

Example 

In this example, information is requested about the status of a system other than the default host system: 



HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

USER CAPABILITY IN EFFECT 

#HOST P 

PLM2 IS THE CURRENT HOST MACHINE 

#OISPLAY STATUS 

PLM2 IS OFF LINE 

TIME LINE DEACTIVATED=FRI, JUN 15, 1984, 4:38 PM 

In the next example the status of a series of jobs is checked: 

#OISPLAY JOB S/7 

J0B#5 IS NOT YOUR JOB 

--J0B#=6 J0BNAME=TEST2 USER=PAT.DCA,M 

PRINT=USERPR NO TRANSLATION PUNCH="LP" F0RMS=USERF0RM 

WAITING TRANSMISSION TO HOST 
J0B#7 IS NOT YOUR JOB 
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The communications link has been established in the next example. The example shows the status of a 
single job. The last line of the example is a response from the host system to the $DJ3022 command 
sent. 

#DISPLAY JOB 2 

--J0B#=2 J0BNAME=TEST1 USER=PAT.DCA,U 

PRINT="LP" PUNCH="LP" FORMS="LP" 

TRANSMITTED TO HOST FRI , JUN 15, 1984, 4:05 PM HOST#=3022 
$DJ3022 DISPLAY COMMAND WILL BE SENT TO HOST. 
$14.11.32 JOB 3022 TEST1 EXECUTING PRIO 6 
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Terminates MRJE/3000 and returns control to MPE. 

Syntax 




Discussion 

MRJE/3000 may be terminated at any time after its prompt (#) has been displayed. 
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Provides a brief description of how to use an MRJE/3000 subsystem command. 

Syntax 




Discussion 

The HELP command is used to obtain brief general information and instructions about how to use 
MRJE/3000 subsystem commands. 

Use ICONTROLI Y in a session to halt the display from this command. 

Parameter 

conmand name This parameter is optional. If absent a list of valid MRJE/3000 commands 

is provided. If this parameter is present it may be any valid command 
name. 



Exampie 

In this example help is requested for the HOST command. 

IHELP HOST 

H[OST] [hostid] 

Select a particular host system to be current. 

# ... 
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Selects a particular host system to be current. 

Syntax 



H[OST] [hostid] 



Discussion 

The system identified by hostid in this command is referenced in all subsequent commands except for 
HELP and EXIT. 

Parameter 

hostid The name of a host system for which the MRJE/3000 Manager built a 

Configuration File. The name can be spelled out or abbreviated to its first 
character. If this parameter is omitted, the default host system is selected. 



Using Host 

Use the HOST command only if more than one host system can be connected to the HP3000. One host 
system should always be designated as the default host system. Its hostid is a blank character. A session is 
automatically associated with the default host system, if it exists, when an MRJE command is issued from 
MPE. A different host may be selected by using another HOST command. To return to the default host, 
the HOST command is issued without using the hostid parameter. MRJE knows the default host only as 
the default system, and not by a hostid. Using a hostid in that situation may cause an error message to be 
sent to the User's terminal. 

Example 

In the following examples, PLM is the name of the default host system and COM2 is the name of a second 
host system. 

#HOST 

DEFAULT HOST ASSUMED 

PLM IS THE CURRENT HOST MACHINE 

#HOST C 

COM2 IS THE CURRENT HOST MACHINE 
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Submits one or more jobs to MRJE/3000 for transmission to a host system. 

Syntax 



S[UBMIT] infile[{opH0riB)] [,^^7/^^e[ (i|i|iii) ] ] 
[ ;R[EADER]=p seudo reader] 
[;PR[INT] = [!]pri/?t/iie[(N)]] 
I;PU[NCH] = [!]pwrtc/7/iie[(N)]] 
[;F[ORMS] = [?]/orm/iie[(N)]] 

t>£>tii^n^ - /N[OTRANSLATE],T[RANSPARENT]\ 
P <-c./fo - ^[TRANSPARENT], N[OTRANSLATE]/ 



Discussion 

Use the SUBMIT command to submit jobs to MRJE/3000. If the MRJE/3000 communications line to the 
host system is open, the job is sent to the host system. If the pseudo reader being used is spooled and 
communications are open, your job is assembled into a spool file before transmission. If the line is not 
open, and it has been configured with a spooled pseudo reader, the jobs are spooled until the line is 
brought up. 

Output from all the jobs submitted in a single SUBMIT command can be sent to: 

• A card punch (with or without special forms) 

• A line printer (with or without special forms) 

• A disc or tape file 

• An HP Laser Printer. 
Designate output to these devices by: 

• A logical device number. 

• An MPE device class name, enclosed in double quotation marks. 

• An unqualified actual file designator. 

• A FortnID, enclosed in single quotation marks. 

• A global file designator, an exclamation mark followed by a seven -character file name. 

• A zero, to indicate unsolicited output. 

The SUBMIT command prohibits specification of more than one HP3000 punch, more than one HP3000 
standard printer, or more than one HP3000 special forms printer at a time. PRINT, PUNCH, or FORMS 
each indicate one output destination. 
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Use either the default file for the output device category, or specify a different file. You can designate a 
print file, punchfile, or formfile value to be a zero (0). A zero value denotes that output is sent to the 
unsolicited output destinations as indicated in the Configuration File on a stream-by-stream basis. Each 
printer or punch stream corresponds to an unsolicited output device configuration. See Configuration File 
items 21-27 and 29-35. Display Configuration File items 20 and 28 to see the default values. 



Parameters 

NOTRANSLATE 



NOTRANSLATE blocks translation of infiles from ASCII to EBCDIC, or as 
specified in item 3 8 of the Configuration File. This parameter must be 
specified for each file that is not to be translated. 



The default translations are ASCII to EBCDIC for input to the host system, 
and EBCDIC to ASCII for output from the host system. 



NOTE 



Do not use this parameter when you specify 
$STDIN or SSTDINX as an infile. 



TRANSPARENT 



Transparent transmission specifies that only the first JOB card of an injile is 
identified, and that all subsequent ones from that infile are ignored by 
MRJE/3000. If the TRANSPARENT parameter is included, the proper 
JCL must still be included so the host system treats JOB cards as data. Use 
a proper DD card. You must be a Manager to use this option in with an 
infile. 



NOTE 



Do not use this parameter when $STDIN or 
SSTDINX are infiles. 



infile 



A maximum of five infiles may be specified. They are transmitted in the 
order listed in the SUBMIT command. Use of the TRANSPARENT option 
is limited to Managers. 



Each occurrence of the infile parameter may be: 

• An actual file designator. It must be qualified if not owned by the logon 
group and account. 

• A formal file designator which has been equated with one of the 
following: an actual file designator, a logical device number, a device 
class name, $STDIN, $STDINX, or $OLDPASS. 

• $STDrN, $STDINX, or$OLDPASS. 
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pseudo reader 



• The logical device number of a real MPE input device. (This allows 
input from a source other than a terminal or disc file. ) 

• The device class name of a real MPE input device enclosed in quotes, 
such as "TAPE" . 

Neither the NOTRANSLATE parameter, nor the TRANSPARENT 
parameter may be specified for $STDIN or $STDINX input files. 

Used to specify the particular MRJE/3000 pseudo reader through which 
the jobs in the input files are submitted. The user may input: 

• The logical device number assigned an MRJE/3000 pseudo reader. 

• A pseudo reader device class name, enclosed in quotation marks. This is 
acceptable only if the pseudo reader the user wants to use is the only 
reader configured with the device class name. 

If the READER^pseudo reader parameter is omitted, the default pseudo 
reader listed in the Configuration File of the current host system is used. 
Display entry 1 9 of the Configuration File to see default reader value. 

A pseudo reader can be used as an unspooled {hot) input device. A hot 
pseudo reader bypasses MPE spooling. You must meet these conditions to 
use a hot pseudo reader: 

• The pseudo reader must not be spooled; 

• The pseudo reader must not be busy, but available; 

• The communication line to the current host system must be open. 



print file 
punch file 
form file 



Used to specify files that are to receive the results of host system job 
processing. One of each type of file can be specified by: 

• The logical device number of an MPE output device. 

• An MPE device class name, enclosed in quotation marks. 

• An unqualified actual file designator. The file must reside in the logon 
group and account. 

• An exclamation mark prefixing a seven character formaldesignator 
which conforms to the file name specifications of MPE, such as 
iOUTFILE. 
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NOTE 



A FILE statement corresponding to the 
formaldesignator must be in 

MRJESTR/?.PUB.SYS. 



A zero (0) character, to indicate use of an unsolicited output device, 
device class, actual file designator, or FORMID configured for the data 
stream. 

A printfile, punchfile, or jormfile which refers to a record in 
MRJETABL. PUB.SYS. This must be delimited by single quote marks, as 
in: 

SUBMIT ... V0mz=' form' \?mCW=' tabcard' 



NOTE 



Do not use the PRINT, PUNCH, and FORMS 

parameters with an RSCS job entry system. 
These have no effect on output routing. All 
output is unsolicited and returned on Printer 
1 with RSCS. Appendix E, EXIT 
PROCEDURE describes how to control 
output when RSCS is used. 



The default output devices for print and punch files are in the 
Configuration File for the current host system. Display items 20 and 28 of 
the Configuration File to identify the default output devices. The default 
value for formfile is also the printfile default value. 

Specific routing of job output to pre-defined files occurs when a printfile, 
punchfile, or formfile is identified with an exclamation mark followed by a 
legitimate seven character designation. This refers to a FILE statement in 
the MRJESTR/? file. 

Whenever a printfile, punchfile, or formfile is a zero character (0), output is 
routed to the printer or punch device associated with the output stream. 
See the discussion on Routing Default Output to Unsolicited Output Devices 
in Section 2, Planning MRJE/3000 Jobs, and Output Management in 
Section 4, Managing MRJE/3000. 

Output sent to spooled output devices is owned by the user and account of 
the submitter. 
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Using Submit 

Jobs are always submitted to the current host system. Unless the HOST command has been used to specify 
another host system, the current host system is always the default host system. It is a good practice to 
precede a SUBMIT command with a HOST command to make sure jobs are transmitted to the correct host 
system. 

An ampersand character (&) can be used in the SUBMIT command as often as needed as a line 
continuation character. Place the & after a file name, or after NOTRANSLATE or TRANSPARENT 
parameters. 

File Names 

Actual and formal file designators used to specify infiles can be qualified names. Actual file designators 
used for printfile, punchfile, and formfile may never be qualified names. If a printfile, punchfile, or 
formfile is a zero character, then output is routed to unsolicited output devices. If a printfile, punchfile, or 
formfile is a FORMID, an eight character string delimited by single quotation marks. Output Management 
of output takes place as indicated by a corresponding entry in MRJETABL. If a printfile, punchfile, or 
formfile begins with an exclamation mark, and is followed by a seven character file designator, then 
specific routing job output takes place. 

Job Output 

The ?RIWJ= printfile and P\iWC\\= punch file and FORl^S= formfile parameters can specify the 
destination of printer, punch, and special forms output generated by the jobs submitted in one SUBMIT 
command. If any of these parameter are omitted, output is sent to the default output device unless JCL 
specifies otherwise. The default printer, Configuration File item 20, also serves as the default value for 
special forms printer output. The default punch, Configuration File item 28, serves as the default value 
for special forms punch output. 

The PRINT, PUNCH, and FORMS parameters may be used only once in the SUBMIT command, regardless 
of the number of different forms called for in the host system JCL. 

If the FORMS parameter is omitted but JCL of a job calls for special forms, the output is sent to the 
default device, printer or punch, given in the Configuration File. For example, if the default print device 
is a line printer, the output is printed on that machine in the format of the special form; that is, as if the 
form had been mounted on the printer. 



NOTE 



SUBMIT command destination parameters override JCL, which overrides 
MRJETABL and MRJECON/i values. 



If output from one or more of your jobs is treated by MRJE/3000 as unsolicited when you had correctly 
specified an output destination, check with the MRJE/3000 Manager or the system operator. The Job 
Log File, MRJEJOB/i, may have been re -initialized since your jobs were sent to the host system. 

Output directed to an HP 2680A Laser Printer can be printed with or without Environment Files. If 
Environment Files are used they can be named in the forms sub -parameter of the SYSOUT parameter of 
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the DD statement in JCL, or specified in an MRJETABL entry. Refer to Section 2, Printing Output on an 
HP 2680 Laser Printer and Specific Routing of Job Output to Pre -Defined Files for more information. 
See Job Output in Section 2, Planning MRJE/3000 Jobs. 



NOTE 



Do not use the PRINT, PUNCH, and FORMS parameters with an RSCS job 
entry system. These have no effect on output routing. All output is 
unsolicited and returned on Printer 1 with RSCS. Appendix E, EXIT 
PROCEDURE describes how to control output when RSCS is used. 



Job Input 

The READER parameter can be used to select a configured pseudo reader other than the MRJE/3000 
default reader for job input. 



NOTE 



Do not confuse a pseudo reader with a physical card reader attached to an 
HP3000. 



Normally the default reader is spooled, so jobs can be submitted without concern for whether the 
communications link with the host system has been established. If the user wishes to submit jobs without 
spooling (hot), an unspooled pseudo reader must be used and the communications line to the current host 
must be open. A reader other than the default pseudo reader is specified in the SUBMIT command 
through the READER parameter. If the default pseudo reader is not spooled, the READER parameter 
need not be used for hot job submission. 



NOTE 



Whenever jobs are submitted through an unspooled pseudo reader, the 
communications line to the host system must be open in order for the 
SUBMIT command to execute successfully. 

Two options are allowed for infiles and FD files, NOTRANSLATE and TRANSPARENT. When the 
NOTRANSLATE option is used with an infile or an FD file, the data to be sent to the host system is not 
translated according to Configuration File item 38. This option allows for the transmission of data 
already translated, or which should not be translated. Packed decimal data, for example, should not be 
translated. When the TRANSPARENT option is used with an infile only the first JOB card in that infile 
is identified, and all subsequent ones are ignored by MRJE. 
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NOTE 

You must be a Manager to use the TRANSPARENT option with an infile. 

When the TRANSPARENT option is specified with an FD card, then all JOB cards are ignored by MRJE. 
Error -free JCL must always be included whenever the TRANSPARENT option is for the host system to 
treat the JOB cards as data. Use the proper DD card. One reason for submitting a JOB to a host system 
as data is to provide for conditional execution of a job. 

As MRJE/ 3000 processes a SUBMIT command, it checks all input files and those FD files for which the 
TRANSPARENT parameter was not included. Whenever MRJE/ 3 000 encounters a JOB card, it assigns a 
unique job number and enters the number in the Job Log File for the current host machine. The job 
numbers are returned to the User in $STDLIST so they can be noted for future reference to individual 
jobs. 

When input originates from $STDIN or $STDINX, the end of every file must be marked with an MRJEOD 
record. This record must contain the characters MRJEOD in the first six columns. It is read by MRJE, but 
it is not sent to to the host system. 
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Example 

In this example, two jobs are submitted to the default host sytem: 

#SUBMIT TEST1iTeST2 

J0B#=5 J0BNAME=J0B1 RECORDS READ=7 RECORDS WRITTEN=7 

DEFAULT IS OFF LINE 

J0B#=6 J0BNAME=J0B2 RECORDS READ=15 RECORDS WRITTEN=14 

DEFAULT IS OFF LINE 

In this example, output file specification is illustrated: 

#SUBMIT TeSTIO(N) ,TEST11 ;PRIt^T=MGRPR;PUNCH=MORPUN;F<^MS=fORM 

J0B#=7 J0BNAME=J0B3 RECORDS READ=20 RECORDS WRITTEN=20 

DEFAULT IS OFF LINE 

J0B#=8 J0BNAME=J0B3 RECORDS READ=7 RECORDS WRITTEN=7 

DEFAULT IS OFF LINE 

#OISPLAY JOB 7,8 

--J0B#=7 J0BNAME=J0B3 USER=JIM.DCA,WILLITS 

PRINT=MGRPR PUNCH=MGRPUN F0RMS=F0RM 

WAITING TRANSMISSION TO HOST 
--J0B#=8 J0BNAME=J0B3 USER=JIM.DCA,WILLITS 

PRINT=MGRPR PUNCH=MGRPUN F0RMS=F0RM 

WAITING TRANSMISSION TO HOST 

The following example illustrates routing output to an alternate FORMID referencing a file equation 
record in the lookup table MRJETABL . A formfile must be delimited by single quotation marks. 

SUBMIT TESTJOB; FORMS =|OTHER 

A FORMID can be used only if MRJE/3000 can access a corresponding entry in MRJETABL. PUB. SYS. 
See Output Management in Section 4, Managing MRJE/3000. 

The following example illustrates routing of default output to unsolicited output devices: 

#SUBMIT ... ;PRINT£R=0 
# ... 

This example illustrates specific routing of job output to pre-defined files. Assume a job is in execution 
using the following MRJESTR.PUB.SYS file from an MRJECONTROL START command: 

?JOB MRJESTR,MANAGER.SYS 

fCOMMENT This job allows users to route output to 

♦COMMENT an HP2680 with a specific environment. 

♦FILE ELITE ;DEV=LPS;ENV=ELITE.HPENV. SYS 

tCOMMENT Note that a stack dump has also been armed. 

♦SETDUMP DB,ST 

!RUN MRJEMON;INFO=" " 

?EOJ 

: HELLO USER. ACCOUNT 
:MRje 
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HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 
USER CAPABILITY IN EFFECT 

ISUBNIT $STDIN;PRINT=tELIT£ 



This example illustrates the use of MRJEOD: 



?JOB NEWJOB,PLM.DOC 

!MRJE 

SUBMIT $STDIN 

//JOBl JOB ... 



Standard MPE job card. 

Calls MRJE. 

Submits JOB 1 to the default host 

system from a batch input device. 



MRJEOD 
DISPLAY J0B1 
EXIT 
!EOJ 



Specifies end -of -file to MRJE. 
Displays job status on $STDLIST. 
Exits MRJE. 
Terminates stream job. 



If MRJEOD is on an input disc or tape file, its image is not transmitted to the host system. 

This illustrates the use of the TRANSPARENT option with an infile. Assume that a catalog file is to be 
stored on the host system disc, and that it is to contain a job named CATALOG. The user should submit a 
job as follows: 

fSUBMIT INPUT(TRANSPARENT) The contents of file INPUT follow: 

//JOBl JOB . . . MRJE recognizes J0B1 . 



//SYSUT1 DD DATA,DLM=$$ 
//CATALOG JOB 



This must precede other jobs. 
This job is not recognized. 



$$ 
/* 



Terminates data. 
Terminates J0B1 . 
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Host job entry system console commands. 

Syntax 



special character corrmxnd string 



PARAMETERS 

special character A special character that begins a host job entry system console command. 

This is usually a currency symbol, $, or an asterisk, *. 



NOTE 



A special character is required for RSCS even 
though MRJE/3000 removes it prior to 
transmitting a command string to the host. 



command string A Manager can use any legitimate job entry system command. An 

MRJE/3000 User must be additionally qualified by Configuration File item 
6. 



Discussion 

An MRJE/3000 User can issue the host job entry console commands that are allowed in the current 
MRJE/3000 Configuration File. If the MRJE/3000 Manager has configured only a single character (for 
example, $), the User can enter commands beginning with that character. On the other hand, if a specific 
command is configured (for example, $DJ), only that console command is available to the User. The 
MRJE/3000 Manager can only allow access to job entry console commands that are allowed to the session 
between the HP 3000 and the host system. The User may not be able to issue every command that can be 
entered at the host system master console. 

The User can display items 6 and 7 of the current Configuration File (using the MRJE/3000 command 
DISPLAY) to see what console commands are available for use. 

Host Console Commands: 

• May be issued interactively while the communications line is active. 

• May be issued as part of an IBM JCL deck. 

• Must conform to the format and restrictions of the host system. 

• Will be refused if issued interactively and any other User, including the Manager, is currently 
communicating with the host system. 
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Host system console commands usually generate output to $STDLIST. The host console communicates 
with only one terminal at a time; therefore, MRJE/3000 limits the User's listings to the configured host 
buffer size, regardless of the command entered. This permits other terminal users to enter host console 
commands and receive responses as well. A [controlI Y can be used to halt a listing and to obtain an 
MRJE/3000 prompt for input (#). Host console commands issued by MRJE/3000 Users may occasionally 
be refused due to heavy console message traffic with the host system, or because someone else is using the 
console. 

Example 

#1111111 Display host job 3022. 

14.11.32 JOB 3022 TEST1 EXECUTING PRIO 6 Host message response. 



NOTE 



The next host system message you receive after a command may not be in 
response to the command you sent. 



3-22 
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Executes an MPE command that can be executed in BREAK mode. 

Syntax 




Discussion 

Any MPE command that can be executed in BREAK mode can be executed within MRJE. So, the RUN 
command can not be executed within MRJE. 

Any command that is ambiguous is executed as an MRJE/ 3 00 command unless it is preceded by a colon 
( : ) character, which indicates an MPE command. When you enter: 

IPURGE OLDJOBS 

entries for cancelled jobs or jobs that are timed out are purged. This is an MRJE/ 3 000 Manager command 
discussed in Section 4, Managing MRJE/ 3000. 

When you enter: 

#iPURGE OLDJOBS 



a file named OLDJOBS in your logon group and account is purged. 
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SECTION 



An MRJE/3000 Manager: 

• Plans data communication facilities; 

• Configures the MRJE/3000 subsystem; 

• Manages subsystem activities; 

• Coordinates use of the MPE distributed console command MRJECONTROL. 

MANAGEMENT SPECIAL CAPABILITIES 

An MRJE/3000 Manager must have MPE System Supervisor (OP) capabilities and must be able to log on 
to MANAGER. SYS. The NEW and PURGE ALL commands can only be issued when an MRJE/3000 
Manager is logged on as MANAGER. SYS,PUB. All other commands described in this section can be issued 
from any logon account and group by any user with OP capabiHty. 

MRJE/3000 HARDWARE 

In addition to an HP3000 computer, MRJE/3000 requires: 

• One or more communications lines to one or more remote hosts. The lines can be switched or leased 
and require compatible modems at each end of a communication line. 

• A communications controller for each communications line used by an MRJE/3000. 

• Terminals, tape drives, and card readers for communicating with MRJE/300Q and submitting jobs. 

Communications Controllers 

MRJE/3000 operation requires one of these communications interfaces: 

• HP30020A/B Intelligent Network Processor (INP), 

• HP30010A Intelligent Network Processor, the Series II/III INP, 

• HP 3005 5A Synchronous Single Line Controller, the Series II/III SSLC. 

After the controllers have been installed by Hewlett-Packard, they must be configured into the MPE I/O 
system as described in Appendix C, Configuring MPE to Include MRJE/3000. 
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Modems 

These modems can be used with MRJE/3000: 

• Bell 201C, 201C-L1D, 208A, 208B, 209A; 

• Bell Dataphone II 2024A, 2048A, 2096A; 

• Bell Dataphone Digital Service (DDS), Data Service Unit (DSU); 

• HP37230T. 

Modem strappings are described in Section 3 of the HP 3000 Data Communications Handbook 
(5957-4634). 

MRJE/3000 SOFTWARE 

MRJE/3000 software consists of these files: 

• A user interface program, MRJE 

• A communications monitor, MRJEMON 

• A job logging process, MRJELOGR 

• A host output data process for each output pseudo device, MRJEOUT 

• A Message Catalog File, MRJECAT 

• Pseudo Device Drivers: lOMRJEO, lOMRJEl, lOMCONSO, lOMPNLPO, and lOMRDRO, 

• A download file for an INP, CSDMRJEO, CSDMRJEl or CSDMRJE2, in addition to its driver 

• A secondary driver for an SSLC, CSSBSCO and CSSMRJEO in addition to its driver 
A description of required and optional MRJE/3000 Management Files follows. 

BSC Link 

MRJE/3000 requires BSC Link (HP30251A). The BSC Link is composed of software, an INP (HP30220B) 
and a cable (HP30221A). When the BSC Link is not used for MRJE/3000, it can be used for other 
products such as RJE/3000 (HP30248A) and IMF/3000 (HP30250A). 

Pseudo Devices 

MRJE/3000 software supports two pseudo line monitors, a pseudo console for operators, and up to seven 
pseudo card readers, seven pseudo line printers, and seven pseudo card punches. Configure a combination 
of no more than eight pseudo line printers and pseudo card punches. These pseudo devices are configured 
into the MPE I/O System as described in Appendix C, Configuring MPE to Include MRJE/3000. 
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BUILDING FILES FOR MRJE/3000 MANAGEMENT 

The MRJE/3000 management files are: 

• The Configuration File, MRJECONfe (where h is the first character of the host identification); 

• The Job Log File, MRJEJOBfz; 

• the Directory File, MRJEDIR/i. 
These files must be in PUB. SYS. 

Other files associated with MRJE/3000 subsystem are: 
. The Message Catalog File, MRJECAT.PUB.SYS; 
. The Stream File, MRJESTRft. PUB. SYS; 

• The Message File, MRJEMSG/i; 

• The Output Management File, MRJETABL. 

Once the MRJE/3000 subsystem and the communications controllers have been configured into MPE, 
management files and other MRJE/3000 files are built. Use these steps as a guide: 

1 . Log onto the HP 3 000 as MANAGER . SYS , PU B 

2. Make certain that MANAGER. SYS has OP capability. 

3. Verify that the Message Catalog File, MRJECAT.PUB.SYS, exists and contains information and 
error messages for the MRJE/3000 subsystem. Use EDIT/3000 or TDP to maintain the Message 
Catalog File. 

4. Build a Stream File, MRJESTR/?. PUB.SYS, for each configured host system. The Stream File is 
used whenever an MRJECONTROL START command is issued from MPE. The contents of the 
Stream File must execute the MRJE/3000 monitor process, MRJEMON. The Stream File must 
contain the command RUN MRJEMON. PUB. SYS; INFO="/?" . In the case of a default host, the 
character h must be a blank. 

Even though Output Management is preferred, a Stream File can still contain FILE statements to 
which users of the MRJE/3000 subsystem can refer when specifically routing job output. See 
Specific Routing of Job Output to Pre -Defined Files, in Section 2, as well as the description of 
the SUBMIT command in Section 3, Commands Available to the MRJE/3000 User. This is a 
typical Stream File for a default host: 

! JOB MANAGER . SYS ; HI PRI ; RESTART ;TIME=? 

! Comment Users can route output to an HP Laser 

!Comment Printer with a specific environment; 

! Comment however, Output Management is preferred. 

?FILE ELITE ;DEV=LPS;ENV=ELITE.HPENV. SYS 

!FILE H0LDLP;DEV=LP,1 

♦Comment The stack dump facility is armed to 
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fComment operate when an MRJEMON problem occurs. 

fSETDUMP DB,ST 

'Comment Set up the Message File. This is an option. 

!Comment If this is absent, messages are not retained 

?FILE MRJEMSG=$STDLIST 

!RUN MRJEMON ;INFO=" " 

•EOJ 



This step is optional. Create a Message File, MRJEMSG/?. PUB.SYS. This is not the Message 
Catalog File, described in step 3. This file receives host console messages, output messages from 
the host system, and a performance measurement data record on output data received. The 
Message File can be a system file, or an actual file. If this file does not exist, then all messages 
are lost; however, the subsystem continues to operate. 

These ways can be used to specify an MRJEMSG/? file: 

• Use a FILE equation with the process used to run the MRJE/3000 monitor. This is a sample 
for host id X, 

:FILE MRJEMSGX=$STDLIST 

This statement should be in a stream job like step 4. 

• Build a circular type file. This is useful when the most recent set of messages from the host 
system need to be retained. This is how host B is identified: 

: BUILD MRJEMSGB;REC=-80,16,F,ASCII;DISC=1024,8,8;CIR 

This Message File can hold the 1 024 most recent messages from host B; however, this file can not 
be read until communication with the host system has ceased, or it is not accessed by any process 
writing to it. 

• Build a pipe or message file. This is useful when it is desirable to read the oldest message 
while writing to the file. The following is an example for a default host: 

: BUILD MRJEMSG;REC=-80,,V,ASCII;DISC=2048,8,8;MSG 
These limitations apply to Message Files: 
Messages are discarded if this type of Message File is filled and no active processes are reading it. 

Communication to the host is suspended when this type of file is full, or until all processes 
reading this type of Message File have closed the file. 

A record ceases to exist once it has been read. One process can be reading from this file while 
another is writing to it. 

Initially the most desirable type of Message File for use at an installation can be one equated to 
$STDLIST because these are output spooled records. 

Both the MRJpLOGR and MRJEOUT processes write to a Message File. The file is opened with 
shared and append access. If this file is not accessible, then messages intended for it are lost, and 
MRJE/3000 operations continue normally. 
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Enter MRJE, the MPE command to start execution of MRJE/3000 subsystem. The subsystem 
first displays the MRJE/3000 banner message, then a message confirming that Manager 
capability is in effect, and then MRJE/3000 prompts for input. For example: 

:H.RJE 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 Banner Line 

MANAGER CAPABILITY IN EFFECT Message 

# . . . Prompt Character 

Finally, build the MRJE/3000 management files using the NEW command. When NEW is 
executed, it requests the following information: 

The number of jobs the Job Log File can accommodate. 

The name assigned to the host system, the host ID. None need be assigned when building 
management files. 

The type of host Job Entry Subsystem. These are HASP, JES2, JES3, ASP, or RSCS. 

The signon card format. 

The logical device numbers that were assigned to the pseudo console device and to the pseudo 
line monitor during MPE configuration. 

The kind of the host system console command an MRJE/3000 User can enter. 

Time when a job becomes old. 

If communications with the host uses a switched line without auto-dialing, then a telephone 
number is displayed at the HP 3 000 system console whenever an MRJECONTROL START 
command is issued from MPE for this line. This telephone number is for the modem at the host 
system. 



NOTE 



Communications can also take place over a switched line with 
auto-dialing, provided that an HP 30020B INP, and a Bell 801C 
auto-dialing unit, and an HP 3022 IG connecting cable are used. 
Telephone numbers can be supplied in the Configuration File. 
The MRJE/3000 telephone number, if present, takes precedence 
over the MPE-configured telephone number. No HP3000 system 
operator message is displayed during auto-diahng. 



After the Manager responds to the prompt messages, MRJE/3000 initializes the job log and 
Directory Files, and initializes the Configuration File using the information just provided. 

The remainder of the configuration items are initialized with MRJE/3000 default values. 
These can be changed later with the ALTER command. Formats and default values for 
Configuration File items are discussed in Appendix A, Configuration File Contents. 

Before any jobs are submitted to the host, examine the Configuration File default values. 
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particularly those pertaining to the host print and punch banners and to the host console ON 
message, Items 8-13 and 37, and Items 15-17, respectively. If the default values do not 
correctly describe what your host does, change them using the ALTER command. 

If you do not specify the host banner format, use ALTER to set Items 8 and 9 to a value of 0. 
Item 8 is the number of lines to check for print banner. Item 9 is the number of cards to check 
for punch banner. Leave the destination for unsolicited print and punch output, Items 21-27 
and 29-35, configured as "LP" if Output Management is not being used. If Output Management, 
MRJETABL, is being used, set items 21-27 and 29-35 to the Form ID for the standard form 
value. 



NOTE 



If your HP 3000 printers are configured with a device class name 
other than "LP", change Items 21-27 and 29-35 to the name used 
in the I/O configuration. 



Then submit a dummy job to the host to create punch and print output. The output from this 
job is unsolicited, and the full banners are printed. Count the columns in the banners to find the 
values for Items 10-13. This job output also shows the values to enter for Items 8 and 9. 

To find values for Items 15-17, you must communicate with the host in Command Mode. This 
is described later in this section in Host Console Commands. Then, from another terminal, 
submit a dummy job to capture the ON message on your terminal operating in Command Mode. 

Also, see Causes and Control of Unsolicited Output in this section. 



MAINTENANCE OF MANAGEMENT FILES 

MRJE/3000 Configuration, Job Log, and Directory Files are created with permanent and modifiable 
information. The modifiable information in the Configuration File can be changed using the command 
ALTER; entries can be deleted from Job Log Files by using the PURGE command; the NEW command can 
be used to purge and rebuild Configuration Files and their associated Job Log and Directory Files. A 
description of maintenance of each file follows. 



NOTE 



The Configuration, Job Log, and Directory Files can not be altered if they 
are in use. Management files are in use when the associated 
communications line is active, or when another user is referencing one of 
these files. 
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Configuration File 



When the MPE I/O system configuration is altered in a way that affects MRJE/3000, its Configuration 
Files may have to be modified to incorporate the change. Some items in the file can be modified using 
the ALTER command. Other items are fixed when the file is initialized. It is necessary to recreate the 
file in order to change some items. Table A- 1 identifies items that cannot be altered. 

If a NEW command specifies a host system for which management files exist, MRJE/3000 prints the 
name of the existing Configuration File and asks if it can recreate it. After a YES response, MRJE/3000 
deletes the Configuration, Job Log and Directory files currently associated with the host and creates three 
new ones. 

Job Log File 

One Job Log File is associated with each MRJE/3000 Configuration File. Each Job Log File is used to 
maintain a record of jobs submitted to MRJE/3000 for transmission to the host, as defined in the 
Configuration File. The Job Log File is built automatically when the Manager uses the NEW command to 
create the Configuration File. The size of the Job Log File is specified by the Manager during execution 
of NEW command. 

The MRJE/3000 Manager can delete entries from a Job Log File using the PURGE command and can 
thus maintain space in the file for new jobs. When the file is full, MRJE/3000 rejects new jobs. PURGE 
ALL causes all entries to be deleted from the file. PURGE OLDJOBS deletes only those jobs that have been 
cancelled, have timed -out, or were not transmitted successfully to the host. 

Once built, it is not possible to expand a Job Log File. Enlarge this file with the NEW command; however, 
this means rebuilding the Configuration File. 

Directory File 

This file requires no maintenance; it is used by MRJE/3000 as an index to the Job Log File. 

The Message Catalog File 

The Message Catalog File is an MPE catalog file used by MRJE/3000 for almost all of the messages sent 
to users and to the system operator. Any modification to the Message Catalog File, MRJEC AT. PUB. SYS, 
must be done according to MPE specifications. Section 6, Management Files, describes building and 
maintenance of files used by MRJE/3000. 

Message File 

The Message File receives host console messages, and other information. If the Message File is an actual 
file, such as MRJEMSG/i.PUB.SYS, information can be read from it. Consideration must be given to the 
kind of file being used because information could be inadvertently destroyed or lost. See Building Files 
for MRJE/3000 Management. 
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Job Stream File 

A Job Stream File, MRJESTR/?. PUB. SYS, is used whenever an MRJECONTROL START command is issued 
from MPE. This file must contain the command RUN MRJEMON ; INF0="/7", where h is the first character 
of the host identification, or a blank character. Other commands can be included in a Job Stream File. 
Maintenance of this file can take place at any time except when a the job is being introduced, and the Job 
Stream File is busy. See Building Files for MRJE/3000 Management and the MPE Commands Reference 
Manual Also consult Troubleshooting MRJE, and Segementing Output Files in this section. These provide 
information about options in running the MRJE/3000 monitor, MRJEMON. 

Form File 

The Form File, MRJEFRM/?. PUB.SYS is used by MRJE/3000 to record the current forms in use by each 
MRJE/3000 output pseudo device. This is an ASCII file of fifteen 8 -character records. 

At startup, MRJE/3000 checks for the existence of the Form File. If it does not exist, MRJE/3000 builds 
it. MRJE/3000 initializes MRJEFRM/? to the values in its Configuration File for Unsolicited Output 
Disposition if Output Management is being used, or to STD. if Output Management, MRJETABL, is not 
being used. 

If the Form File does exist at startup, MRJE/3000 uses the values in this file to initialize its current form 
variables. The host typically remembers the form on each MRJE/3000 device from one of its sessions, a 
SIGN ON, to another. So, MRJE/3000 synchronizes its use of forms with the host: 

• MRJE/3000 reads the Form File every time communications are started; 

• MRJE/3000 updates the Form File each time a command is received from the host to mount a new 
form on a printer. 

This file can be read by FCOPY or EDIT/ 3 000 to display the last form used on each pseudo device. The 
format of the file is: 

Record: Current FORMID for: 

Unused. 
1 - 7 Printer streams 1 - 7 
8-15 Punch streams 1-7 



NOTE 



Although the Form File requires no maintenance, operator intervention is 
required if the host system was restarted since its last host session. A 
session begins when MRJECONTROL START successfully sends a SIGN ON 
to the host. The host does not usually remember the names of special forms 
in use at remote sites from one startup to another. Then the HP3000 
operator should purge the file MRJEFRM/?. PUB.SYS before issuing an 
MRJECONTROL START command from MPE. MRJE/3000 rebuilds and 
reinitializes the file to configuration default values. 

To override this feature, and to make MRJE/3000 start every host session with standard forms, precede 
the RUN MRJEMON command with a PURGE MRJEFRM/z. This illustrates the sequence of commands 
when host ID B is used. 
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♦JOB MRJESTRB, MANAGER. SYS, PUB;HIPRI 
tComment Always arm stack dump. 

tSETDUMP DB,ST 



tComment Overrides Form File feature, 

♦PURGE MRJEFRMB.PUB 

♦RUN MRJEMON.PUB.SYS;INFO="B" 



Output Management File 

The Output Management File MRJETABL is an optional file maintained by the system administrator. This 
is an 80-character ASCII file which can be built with an editor such as EDIT/3000 or TDP. There is 
only one Output Management file for an HP3000 system, not one per configured host. The Output 
Management file is required for any of these features: 

• Output routing of unsolicited output. 

• Output routing to an HP Laser Printer using environment files. 

• Configuring standard forms other than STD. 

• Support for non-alphanumeric form names. 
Output Management in this section describes this file. 

OUTPUT ON AN HP LASER PRINTER 

For information on running output to an HP Laser Printer, consult Output Management. 

SEGMENTING OUTPUT SPOOLFILES 

When routing output to spooled printers it may be desirable to segment large output data sets into 
multiple spoolfiles. Use the RUN parameter PARM in the MRJE/3000 Stream File, 
MRJESTR/i. PUB. SYS. Set this parameter to any non-zero positive value. MRJE/3000 counts the 
number of page eject characters received from the host for all print output destined for a spoolfile. When 
the number of page ejects equals the value supplied in PARM, MRJE/3000 closes the output spoolfile and 
opens a new spoolfile with the same file name and output file specifications. MRJE/3000 then prints a 
single page with five lines from the original banner page and continues processing. The PARM value is 
set to 1000 in the RUN command: 

♦JOB MRJE, MANAGER. SYS 

!RUN MRJEMON.PUB;INFO=" ";PARM=1000 

If MRJEMON, the MRJE/3000 monitor, receives more than lOOO page eject characters in a data set sent 
to a spoolfile, it segments the spoolfile. Segmenting can only occur for print output going to a spoolfile. 
Segmenting is not done for output sent to non-spooled devices, or for punch output. 
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NOTE 



MRJE/3000 output spoolfile segmenting is based upon the actual number 
of page ejects received from the host. The number of page ejects received 
may not necessarily match the number of logical pages received. This 
depends upon the host configuration for maximum lines per page, such as 
the JES2 $LINECT parameter. If the number of pages per segment printed 
by MRJE/3000 does not match the FARM value then first check the host 
configuration. Users can override this host parameter with the LINECT 
parameter of the JOBPARM control card. 



MRJE/3000 outputs a five -line banner page in front of each subsequent segment. 
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OUTPUT MANAGEMENT 



Output Management can be used to route host output to a final destination on an HP 3 000. It is based 
upon instructions sent by the host to the remote workstation to control operation of the remote print 
devices. MRJE/3000 interprets an instruction from the host to mount a special form as a directive to 
route output to the destination file FORMID where FORMID is the name of the special form present in 
MRJETABL. Host output can be either solicited or unsolicited. The output file characteristics for each 
FORMID are described in a lookup table, usually file MRJETABL. PUB. SYS. MRJE/3000 uses this table 
to perform a mapping from forms as understood by the host to files as understood by the HP 3 000. 
Output Management requires file MRJETABL. PUB. SYS, or a file equation to MRJETABL preceding 
MRJEMON execution. 

Use Output Management with an RSCS job entry system as all output received is unsolicited. Appendix E, 
Exit Procedure, describes a method for processing host special forms setup messages. 

Output Management is activated by the System Administrator by performing these two steps: 

1 . For each MRJE/3000 output device in use, set MRJECONh items 20-35 (default output 

disposition) to the name of the default form as configured on the host. Each entry must be 
delimited by single quotes ('). If the host standard form identification includes a period ( . ), 
then the period must be included in the Configuration File entry. Periods as well as any 
alphanumeric or IBM national character (#, $ or (§) can be used. 

If the default standard form configured on the host is STD., then Configuration File item 20 
should be set as follows: 

20. PRINT OUTPUT DEVICE=|STD.|| 

An entry with STD. as a FORMID must be in MRJETABL. 

A similar entry should be made for each MRJE/3000 output device configured into the MPE I/O 
system. 

2. Build file MRJETABL. PUB. SYS using EDIT/3000 or TDP. This file must contain entries for any 

standard form identified in the MRJECON/i file for every solicited and unsolicited output as well 
as entries for all special forms to be supported on the remote workstation. Records of this file are 
used to form equation specifications to identify output destinations for all standard and special 
forms. A typical entry for the standard form STD. is: 

STD. dev=epoc;env=lp602.hpenv 

A FILE statement equating MRJETABL to another file can precede MRJEMON execution; 
however, this limits use of the MRJECONTROL VERIFY command. 



CONSIDERATIONS FOR BUILDING MRJETABL 



Use the MPE Commands Reference Manual and the MPE Intrinsics Reference Manual for additional 
information on FILE equation -like specifications in MRJETABL. 
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One Output Management table file, MRJETABL, serves an HP3000 system. If multiple hosts are accessed 
from an HP 3 000 acting as a remote workstation, then each use of MRJE/3Q00 accesses the same table, 
usually MRJETABL. PUB. SYS. 

Using a File Equation 

MRJE/3000 allows file equations in opening of MRJETABL. If necessary, a system administrator can 
redirect the reference to an alternate file. The lookup table could be named MRJETBLX. A file 
equation in MRJESTR/i. PUB. SYS such as 

!file mrjetabl=mrjetblx 

preceding MRJEMON execution causes MRJE/3000 to access the file MRJETBLX. 

Record Specifications 

An MRJETABL file can have data records up to 260 characters long. Data records less than the 
maximum are continued by using an ampersand (&) as the last non-blank character. For example, 

LONGONE ;dev=pp;& 
Env=ABC.HPENV.SYS 



is equivalent to 

LONGONE ;dev=pp;Env=ABC.HPENV.SYS 
The file can be kept in numbered or unnumbered form. 

FORMID Specifications 

A FORMID identifies a record in an Output Management File. It is composed of alphanumeric and 
certain special characters. If a FORMID is less than eight characters long, it must be filled with trailing 
blanks. When a FORMID includes a period (.), it must be included as part in the table entry. For 
example, the default JES2 standard form is STDI, not STDIIL 

FORMIDs must begin in column one and can contain a maximum of 8 characters. Valid FORMID 
characters are: 

• IBM National characters. These are #, a pound symbol; $, a dollar (currency) symbol; and @, an at 
symbol. 

• A period ( .) character. 

• All alphanumeric characters. 
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NOTE 



There is no distinction between upper and lower case characters 

The first eight characters of an MRJETABL record are the FORMID. Characters beginning with the 
ninth position in an MRJETABL record are file attributes. A FORMID can begin with any alphanumeric 
or IBM national character. If a FORMID contains fewer than 8 characters, the remaining characters 
must be blanks. The remainder of the record must contain file equation specifications. 

std. ;dev=pp;env=lp602.hpenv 

123456789 ... 80 

The preceding record has a four -character FORMID, STD., followed by four blanks. This record causes 
all host output for the form 'STD. ' to be routed to device class PP using environment file 
LP602.HPENV.SYS. 



NOTE 



The SYS account is always used in an entry unless an account name is 
specified. 

MRJE/3000 searches MRJETABL linearly for a FORMID. So, the most frequently used FORMIDs should 
be at the beginning. MRJE/3000 recognizes the first occurrence of a FORMID. 

MRJETABL entries can be added at any time; however, changes and deletions must be made when 
MRJE/3000 is inactive. It is not necessary to deactivate or signoff from MRJE/3000 before augmenting 
the table with new entries. These additions take effect immediately. 



CAUTION 



You must signoff, MRJECONTROL SIGNOFF, before modifying or deleting an 
MRJETABL entry. Restart MRJE/3000 after MRJETABL has been changed. 
Do not attempt to delete or modify any records in MRJETABL while 
MRJE/3000 is active. MRJE/3000 supports additions to MRJETABL 
while active. MRJE/3000 does not support deletions or modifications to 
MRJETABL while active. 

MRJE/3000 accesses the permanent file only when necessary to update its 
internal data structures. Output routing is unpredictable if any records are 
modified or deleted while MRJE/3000 is active. Refer to the MRJE/3000 
Operation with MRJETABL. 
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MRJE/3000 OPERATION WITH MRJETABL 

MRJE/3000 operation with MRJETABL applies to print and punch output. 

Initialization: At startup, in Output Management mode, MRJE/3000 verifies standard form entries in 
MRJETABL and all entries that correspond to Configuration File items. The Error Recovery section, 
following describes how failures are processed. 

Output Processing: MRJE/3000 continually monitors communications from the host to identify form 
setup messages, and output data sets. When a form setup message is received, MRJE keeps track of it as 
the current form in MRJEFRM/?. PUB. SYS. All data sets received are tested to determine if the output is 
soHcited or unsolicited. Solicited data sets are tested for an alternate form. MRJE/3000 always routes 
output to the current form unless an alternate form has been specified. 

If a FORMID cannot be found in an internal copy of MRJETABL, MRJE reloads it and searches for the 
FORMID a second time before entering error recovery mode. 

When MRJE/3000 retrieves a FORMID, it executes a file equation using the jobname obtained from the 
banner of the output data set as the file name. An X is substituted for any national characters (#, $ or @) 
in a jobname. An X also replaces a numeric first character in a jobname. So, a job named 1$2@ becomes 
XX2X. 

MRJE/3000 opens the file corresponding to the output data set with these file system options, unless 
otherwise specified: 

• Append access; 

• ASCII, unless a notranslate option is specified by a solicited user; 

• Shared access; 

• Device Class DISC; 

• Dynamic Locking, if a disc file; 

• Old and Permanent, if a disc file; 

• Carriage Control, if printer output; 

• No Carriage Control, if punch output. 
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These file specifications correspond to aoptions = %343 for print and punch output, and 
f opt ions = 9^«40 5 for print output, or f opt ions = %5 for punch output. 



NOTE 



Specify any alternate output file characteristics in an MRJETABL record. 
File equation parameters override file opening, FOPEN, specifications. 
Consult the MPE File System Reference Manual for additional 
information. 

ERROR RECOVERY, which follows, describes alternate procedures for output routing if an error occurs. 
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MRJETABL EXAMPLES 



Each entry in MRJETABL is identified by a FORMID in positions 1 - 8. The parameters following a 
FORMID function like a FILE command from MPE. 



std. ;dev=pp;ENV=LP602.HPENV 

This record causes all output for the form STD. to be routed to device class PR using environment file 
LP602.HPENV.SYS . The SYS account is assumed because it is the logon account of the user in the 
MRJESTR/? job running MRJE. This is a JES2 default standard form. A period (.) is a part of the 
FORMID and must be included in the record entry. Assuming that standard form STD. is the most 
frequently used FORMID, make this the first entry in MRJETABL because MRJE/3000 performs a linear 
search when accessing the table. No distinction is made between upper and lower case characters. 

12 ;dev=EP0C,4,2;env=lplong.HPenv 

This causes all output for form 12 to be routed to device class EPOC. The output priority is 4. Two copies 
are to be printed. The environment file is Iplong. hpenv. sys . 

5927 ;DEV=LPS,,5;ENV=LP60LONG. HPENV 

This causes all output for form 5927 to be routed to output device class LPS. The environment file is 
lp601ong. hpenv. sys . Five copies are requested. The HP3000 system default output priority is used. 
This is 8 if spoolf ile logging is enabled, and 1 3 if it is disabled. 

payroll ;DEV=EP0C,5,3;ENV=CHECKENV.HPENV;forms=checks. 

This entry routes output for the special form PAYROLL to device class EPOC. The output priority is 5. 
The environment file is checkenv. hpenv. sys. When the spoolfile becomes active on the HP3000, a 
forms mount message is displayed on the system console for the special form CHECKS. 



NOTE 



The forms parameter should always be placed after the env parameter. 

The payroll FORMID has more than four characters. Some host systems 
support four characters or less for a special form identifier in their job 
control language. However, a user can direct forms output to this entry by 
using the SUBMIT command with solicited output this way: 

SUBMIT jo6A?ame;F0RMS=' PAYROLL' 
This payroll entry in MRJETABL creates three copies of all paychecks ! 
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disc =myclata.mrje, new; save 

Output is routed to a disc file with the above entry. Output destined for the FORMID d isc is sent to the 
disc file mydata.mrje. sys . The ,new parameter overrides the default value of old. MRJE/3000 builds 
the file. 



CAUTION 



If the file already exists as a permanent file, then MRJE/3000 can not close 
the file successfully. In such cases the output is lost. 

Files can not be built across accounts. Use the , new parameter to build files in the SYS account. 

ciisc2 =disc2.mrje.myacct;acc=out 

This entry causes all output for the FORMID disc2 to be routed to disc file disc2.mrje,myacct . This 
file must be built in advance, as MRJE/3000 assumes that the file already exists unless the ,new 
parameter has been specified. A ,new option could not be used here because MRJE/3000 cannot build 
files across accounts. The acc=out parameter specifies write access. This supersedes the MRJE/3000 
default access of append . Any data in the file is overwritten. 

$@@long#;dev=pp;env=lp604.hpenv 

A FORMID can begin with numeric or IBM national characters (as well as alphabetic characters) and can 
be up to 8 characters long. Output routed to FORMID $@(01ong# is sent to device class PP using 
environment file lp604.hpenv.sys . 

test =special;dev=pp,3;forms=special . 

This entry causes the file system to override file naming convention used by MRJE. The output file is 
named SPECIAL rather than jobname. The period (.) in the forms parameter is required to designate a 
form. The device class is pp. The specified output priority is 3. The form name in this example matches 
the file name assigned to the spoolfile. This enables HP3000 operators to more readily identify the names 
of special forms required by spoolfiles as the SHOWOUT output indicates the name of the form required. 

newfile , new; save 

This causes MRJE/3000 to build a new file in the MRJE/3000 logon group and account, PUB. SYS, using 
jobname as the filename. This entry provides a mechanism for routing either solicited or unsolicited 
output to disc, and building a new file using the name of the job as the filename. 
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CAUTION 



You can only do this in PUB. SYS as file equations of this type apply only to 
the logon group and account. 

Always use a unique jobnatne with this feature, otherwise data can be lost 
in an attempt to create duplicate permanent files. 



Limitation 

MRJE/3000 Output Management does not support any privileged mode file system options, NOMA IT 
I/O, or MR (multi -record access). 

LASER Printers and Alternate Character Sets 

If you use alternate character sets, include the special codes to switch from one set to the other. The 
special codes can be ASCII shift -in (SI) and shift -out (SO) control characters, or they can be imbedded in 
the data to cause a shift from one set to the other. 

The special code is built in to each character by turning the bit eight on or off. When bit eight is off, the 
character is printed from your primary character set. When the bit eight is on, it is printed from your 
secondary character set. 

Put the shift -in (%17) and shift -out (%16) characters in each data record wherever you want to switch 
between character sets. An SI character selects characters that follow from your primary set. An SO 
selects the subsequent characters from your secondary character set. Each SI and SO remains in force 
until the end of the record, or until another SI or SO character is encountered. 
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ERROR RECOVERY 

MRJE/3000 Output Management executes error recovery procedures: 

• FORMID not found in MRJETABL ... message. 

• Invalid file equation record, a COMMAND intrinsic error message. 

• Failure to open output file, an FOPEN intrinsic error message. 

MRJE/3000 displays an error message on the HP 3000 console whenever one of these error occurs and also 
prints a log of all errors on the $STDLIST device for the monitor process, the output of the MRJESTRft 
Stream File. 



NOTE 



MRJE/3000 also prints error messages on the $STDLIST device of the 
monitor process. This is output from the job initiated by the MRJESTRft 
file. In addition to these error message, a PRINT 'FILE 'INFO intrinsic file 
information display is printed on SSTDLIST to describe the nature of the 
failure. Consult the MPE Intrinsics Reference Manual for additional 
information on PRINT'FILE'INFG. 



FORMID Not Found ... 

A formid can be requested by: 

• MRJE/3000 receiving a formid setup message from the host. 

• A SUBMIT command PRINT, PUNCH or FORM formid parameter specification. 
If the formid is absent from MRJETABL, MRJE/3000 prints: 

MRJE WARNING: FORMID not found in MRJETABL. PUB. SYS . 

MRJE FORMID not found = form 

MRJE Used default FORMID of default for job jobname 

MRJE Used output priority of 2. 

The standard form default values are MRJECON/i Configuration File items. These are: 
Item Contents 

20 DEFAULT DEVICE FOR PRINTER OUTPUT, for solicited printer output. 

28 DEFAULT DEVICE FOR PUNCH OUTPUT, for solicited punch output. 

21 - 27 UNSOLICITED PRINT DISPOSITION , for printers 1 - 7, respectively. 

29 - 35 UNSOLICITED PUNCH DISPOSITION , for punches 1 - 7, respectively. 
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MRJE/3000 uses output priority 2. This usually means that the output is deferred. The system operator 
can work with the affected user to route output to its proper destination. Lowering the system outfence 
value to 1 causes all such output to become ready. 

The system administrator can override an output priority 2 in a file equation record. File equations 
always override FOPEN specifications. In this case, the applicable message in MRJECAT. PUB.SYS file 
should be modified. This also routes all output to the standard form at the specified priority, instead of 
the system default value. 



NOTE 



An exception exists to this error recovery procedure: 

When communications with the host are started, MRJE/3000 checks for 
the existence of the standard FORMID in the table and attempts to open 
and then close it. If the file is spooled, MRJE/3000 deletes the output file. 

If this procedure fails, then MRJE/3000 aborts with an error message. If 
the FORMID is not found, the message is: 

ERROR: Config FORMID not found in MRJETABL. 

FORMID not found = form 

PRINTER (OR PUNCH) N TERMINATING 

MRJE/3000 aborts if this error occurs at startup while attempting to verify Configuration File defaults. 
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Invalid File Equation Record ... 

If an invalid file equation is encountered, MRJE/3000 uses the default FORMID identified in the 
MRJE/3000 Configuration File with an output priority of 2. 

This error message appears on the HP 3 ODD console if the FORMID is found in the lookup table, but 
MRJE/3000 COMMAND intrinsic fails: 

MRJE Failure to execute MPE "COMMAND" Intrinsic. 

UNKNOWN DEVICE CLASS. (CIERR 344) 

Command PARM = 3 

MRJE FORMID = form 

MRJE The following file equation was attempted: 

FILE joi)A7a/ne;DEV=N0TTHERE;ENV=ELITE.HPENV 

MRJE Used output priority of 2. 

The line Command PARM = 3 in this message identifies the parameter number in error in the file 
equation that follows. Consult the MPE Intrinsics Reference Manual about the COMMAND intrinsic for 
additional information. In this example, the error was due to an invalid device class, NOTTHERE . If such 
errors occur, MRJE/3000 uses the default form identified in the Configuration File with an output 
priority of 2. 



NOTE 



An exception is when an error occurs when starting communications with 
the host, while attempting to verify the configuration entries. A message 
equivalent to the above appears, with the last line replaced by: 

ERROR : Failure to open default form 
PRINTER (OR PUNCH) N TERMINATING 

MRJE/3000 aborts if this error occurs at startup while attempting to verify Configuration File defaults. 
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Failure to Open Output File ... 

If MRJE/3000 fails to open the output file, then the error recovery described for Invalid File Equation 
Records is performed. 

This sample error message is sent to the HP3000 console if MRJE/3000 does find the FORMID, and 
successfully executes the MPE COMMAND intrinsic but fails to execute the FOPEN intrinsic: 

MRJE ERROR: MRJEOUT, OPEN FAILURE (154) ON MRJEOUT 

ENVIRONMENT FILE OPEN ERROR (FSERR 154) 

MRJE FORMID = formname 

MRJE The following file equation was attempted: 

FILE jo6«ame ; DEV= PP ; EN V= I NVAL I D.H PEN V 

MRJE Used default FORMID of default for job jobname 

MRJE Used output priority of 2. 

In this example, the environment file does not exist. MRJE/3000 uses the default FORMID for this job 
with an output priority of 2. 

MRJE/3000 aborts if this error occurs at startup while attempting to verify Configuration File default 
values. 
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VERIFYING THE CONTENTS OF MRJETABL 

After building the lookup table MRJETABL. PUB. SYS, verify all records. Use the MRJECONTROL VERIFY 
command from MPE. 

If MRJETABL. PUB. SYS contains 12 records, the following display appears when all records are successful 
:MRJ£CONTf?OL VEf?IFY 

MRJE/3000 prints a dot ( .) as each record 

is successfully verified. 

ALL RECORDS PASSED 

END OF PROGRAM 

MRJE/3000 programmatically issues a file equation using the file name TESTa? where n is an integer from 
to 9999. MRJEOUT then calls FOPEN followed by FCLOSE. If the output file is spooled, MRJE/3000 
deletes it. 

If any records fail, then MRJE/3000 prints a COMMAND intrinsic failure message, or FOPEN intrinsic 
failure message, and then continues until all records have been tested. After testing the last record, MRJE 
prints this message: 

N RECORD(S) FAILED 

The MRJECONTROL VERIFY command can be terminated by a (BREAK) or (CONTROL) Y at any time. 



NOTE 



An MRJECONTROL VERIFY can only be used for MRJETABL. PUB. SYS. 

It can not be used when FILE equation from MRJETABL exists to another 
file. 
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MANAGER COMMANDS 



The MRJE/3000 Manager commands are summarized in Table 4-1. These commands are used during an 
MRJE/3000 session to configure MRJE/3000 and to supervise its use. The MRJE/3000 Manager can use 
all the User commands and has access to all host console commands available to a remote console. See 
Section 3, Commands Available to the MRJE/3000 User, and CONVENTIONS. 



Table 4-1. Summary of MRJE Manager Commands 



COMMAND 



ALTER 



\itemlistj^ 



Uob# 
CANCEL JOBS Ijobname 
yjoblist^ 



DISPLAY 



HOST 

JOBLOG 

STATUS 
CONFIG 



»job# 
, jobname 
, joblist^ 

f',item# "I 
\,itemlist/ 



host console command 



NEW [hostid] 



PURGE 



/OLDJOBS 

\all 



} 



FUNCTION 

Specifies the items to be changed in the 
Configuration File. 

Cancels one or more jobs. 



Displays name of currently selected host system, 
status of current and old jobs, line status (open or 
closed) and subsystem configuration information. 



Transmits a HASP, JES2, JES3, ASP, or RSCS 
command to the host system. Output may be 
received at $STDLIST, and optionally at 
MRJEMSGft. 

Used to build or rebuild an MRJE/3000 
Configuration File. 

Purges entries from the Job Log File. 
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Modifies entries in a Configuration File. 

Syntax 



A[LTER] 



(item# \ 
\itemlist) 



Parameters 

item# The number assigned to an entry in the Configuration File. Some entries 

cannot be altered. These are indicated in Table A- 1. 

itemlist A list of item numbers. 

Additional information on iYem# and itemlist is in the Glossary, Appendix F. 

Discussion 

Configuration File entries and their corresponding item numbers are shown in Appendix A, Configuration 
File Contents. The ALTER command always references the Configuration File of the current host 
system. Use HOST to specify another host system. If the number of an unmodifiable entry is entered, 
MRJE/3000 prints an error message. 

When the command executes, MRJE/3000 prints the description and current value of a designated item 
and then prompts for a new value. Enter a new value in the format shown in Appendix A, Configuration 
File Contents, or type a carriage return to retain the current value. 
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Example 

Notice the changes in the logical device numbers for the default host system after a change in MPE 
configuration. The HOST command was issued before ALTER to be certain the command would 
reference the correct set of files. 

:MRJE 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

#HOST 

DEFAULT HOST ASSUMED 

PLM IS THE CURRENT HOST MACHINE 

#ALTEf? 2,3 

2. PSEUDO CONSOLE DEVICE=042 

NEW VALUE= 

m 

3. PSEUDO LINE MONITOR DEVICE=040 
NEW VALUE= 

■ 

MRJECON SUCCESSFULLY ALTERED 

An attempt has been made to change the number of entries a Job Log File can accommodate. The 
attempt failed because the size of the Job Log File cannot be altered without rebuilding the 
Configuration File: 

#HOST C 

COM2 IS THE CURRENT HOST MACHINE 

#ALTEf? 18 

18. MAXIMUM NUMBER OF JOBLOG ENTRIES=150 

THIS ITEM NOT DYNAMICALLY CONFIGURABLE 

MRJECONC NOT ALTERED 



NOTE 



Since COM2 is a system other than the default host system, the 
Configuration File name is MRJECONC. 
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Cancels one or more jobs. 



Syntax 




Discussion 

The CANCEL command is used to cancel jobs that have been submitted for processing on the host. For 
jobs not yet transmitted to the host, CANCEL deletes the specified job number, name or list, and marks 
the corresponding entry in the Job Log File as cancelled. If the job has been transmitted and the host is 
on-line when this command is issued, a cancellation command is sent to the host and the Job Log File 
entry is marked as cancelled. 



NOTE 



Every cancellation identifies a job as an old job. Once a cancelled job has 
completed execution at the host, and any data sets have been transmitted 
and ignored by MRJE/3000, issue a PURGE OLDJOBS command from 
MRJE/3000. The command is described in this section. 



If the job has been transmitted but the host is off-line, the Job Log File entry is marked as cancelled; any 
output from the job that is received by MRJE/3000 when the communications line is reopened is 
discarded. The CANCEL command does not delete entries from the Job Log and Directory Files. Every 
cancellation identifies a job as an old job. Once a cancelled job has completed execution at the host, and 
any data sets in process have been transmitted and discarded by MRJE/3000, issue a PURGE OLDJOBS 
command from MRJE/3000 to reclaim Job Log and Directory File entries. 



NOTE 



Do not use this command with an RSCS job entry system. 



Parameters 

JOBS 

job# 
jobname 



Optional parameter, provided for consistency with the DISPLAY command. 
Omitting JOBS has no effect. 

The number MRJE/3000 assigned to a job at submission. 
The name on a JOB card in an input file. 
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joblist A list of job names and job numbers. 

Additional information on job^, jobname and joblist is in the Glossary, Appendix F. 

Using Cancel 

Since the CANCEL command always refers to files that were created for the current host system, issue a 
HOST command first to be certain the proper Job Log File is used. 

Following a CANCEL command, MRJE/3000 displays the status of the specified job(s) and asks for 
cancellation confirmation. A YES response confirms the cancel request while any other response including 
Y causes the command to be ignored. 

Although either the number or the name of a job can be specified, the number is preferable because it 
defines a specific job and gives a faster response. If a job name is specified for cancellation and more than 
one job with the same name has been submitted, MRJE/3000 prints: 

jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY OF JOBS WITH THIS 
NAME WHICH YOU OWN (IF ANY) FOLLOWS: 



This is followed by a list of all jobs with the given name and their assigned job numbers. No cancellation 
occurs. With duplicate job names, the CANCEL command should include the unique job number, rather 
than a common job name. 

Example 

In the first example, job number 25 has been cancelled. 



NOTE 



The HOST command was issued first to be certain the command referenced 
the correct set of files. 



HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

#HOST P 

PLM2 IS THE CURRENT HOST MACHINE 

#CANC€:L 25 

--J0B#=25 J0BNAME=TESTJ0B2 USER=PAT. DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 

VERIFY CANCEL WITH "YES" 

YES 

SPOOL FILE DELETED 

J0B#25 CANCELED 
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In the next example, three jobs have been cancelled with one command. 



NOTE 



MRJE/3000 J0B#=4 corresponds with HOST#=2018, 



DEFAULT HOST ASSUMED 

PLM IS THE CURRENT HOST MACHINE 

#CANCEL 22,3/4 

--JOB#=22 JOBNAME=MYJOB USER=PAT.DCA,M 

PRINT=USERPR NO TRANSLATION PUNCH="LP" FORMS=USERFORM 

WAITING TRANSMISSION TO HOST 
VERIFY CANCEL WITH "YES" 

III 

SPOOL FILE DELETED 

J0B#22 CANCELED 

--J0B#=3 J0BNAME=MYJ0B2 USER = PAT. DCA,M 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
VERIFY CANCEL WITH "YES" 

III 

SPOOL FILE DELETED 

J0B#3 CANCELED 

--J0B#=4 J0BNAME=MYJ0B3 USER=PAT.DCA,M 

PRINT="LP" PUNCH="LP" F0RMS="LP" 

TRANSMITTED TO HOST FRI, JUN 15, 1984, 3:20 PM HOST#=2018 
VERIFY CANCEL WITH "YES" 
YES 

$CJ2018, 2018 CANCEL COMMAND WILL BE SENT TO HOST. 
$15.35.40 JOB 2018 ON RM31.PR2 PRIO 9 PURGE 



4-29 



DISPLAY 



Displays job and system information. 



Syntax 





'H[OST] i 








'Job^ ■ 








J[OBLOG] 1 


jobname 
joblist 






D[ISPLAY] 


0[LDJOBS] 
S[TATUS] 

ClONFIG] iffj^'"* ^ 
'[itemlistj 





Discussion 

The DISPLAY command is used to display the name of the current host, information about active and 
inactive jobs in the Job Log File, the status of the communications line to the host, or the contents of the 
Configuration File for the current host. Use [CONTROLl Y in a session to halt display command output. 

If no parameters are used the JOBLOG option is assumed. 



Parameters 

HOST 
JOBLOG 



Lists the current host system. This system is referenced by the SUBMIT, 
DISPLAY, ALTER, PURGE, and CANCEL commands until the HOST 
command is issued to select another system. 

Displays information about jobs. If neither )ofc>#, jobname, nor joblist is 
specified, the entire Job Log File for the current system is displayed. 

JOBLOG is the default parameter for the DISPLAY command. 



NOTE 



This parameter should not be used with an 
RSCS job entry system. A job will always be 
identified as WAITING TRANSMISSION TO 
HOST because RSCS does not acknowledge 
that a data set has been received. Use a host 
console command to inquire about the status 
of a job. 



OLDJOBS 



Reports entries for cancelled jobs and jobs that have timed -out. Timed -out 
jobs are jobs that have been in the Job Log File for a period of time, equal 
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to or greater than the time limit configured in item 42 of the 
Configuration File. The time limit is measured from the point of successful 
transmission to the host. 

STATUS Reports whether the communications line to the current host system is open 

or closed. 

CONFIG Lists the contents of the Configuration File for the current host system. If 

item numbers are included, only the corresponding entries are displayed. 
Appendix A, Configuration File Contents, describes the the Configuration 
File structure and its entries. 

The iofc>#, jobname, joblist, item#, and itemlist parameters are described in the Glossary, Appendix F. 

You must be a Manager to DISPLAY 

• Jobs that are not in your logon username. acctname. 

• OLDJOBS 

• Certain items in the Configuration File 



Using Display 

The DISPLAY command always references the set of files that were created for the current host system. 

If a generic job name is specified with the JOBLOG parameter, all instances of that job name are 
displayed, whether they belong to one or several users. 

If the DISPLAY JOBLOG command is entered with jobname, job^, or joblist during an interactive session 
and while the communications link is connected, MRJE/3000 sends a display command to the host to 
obtain the status of jobs already transmitted. 

To obtain a line printer listing of a Configuration File, issue these commands: 

:fILE LISTING; D£:V»LP 

.-HRJC 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

#lliHH Defines host C to be the current host. 



#OISPLAY C 1/43 Also displays Configuration File items on $STDLIST. 



#1111 
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Example 



This example displays the status of a single job. The communications link has been established: 

:NRJE 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

IDISPLAY JOB 4 

--J0B#=4 J0BNAME=J0BQA31 USER=MANAGER.SYS, PUB 
PRINT=MGRPR PUNCH=MGRPUN FORMS=MGRFORM 
TRANSMITTED TO HOST FRI, JUN 15, 1984, 3:20 PM HOST#=2018 

$DJ2018 DISPLAY COMMAND WILL BE SENT TO HOST 

$15.34.52 JOB 2018 J0BQA31 EXECUTING PRIO 6 

This example displays line status for the current host system: 

#DISPLAY STATUS 

HP IS OFF LINE 

TIME LINE DEACTIVATED=FRI, JUN 15, 1984, 4:38 PM 

This example displays items in the Configuration File: 

#DISPLAY CC^FIO 6,7 

6. USER HOST COMMAND=$DA 

7. COMMAND CHARACTER=$ 
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Creates or recreates the Configuration, Job Log, and Directory Files for a given host system. 

Syntax 



N[EW] [hostid] 



Discussion 

The MRJE/3000 manager must be logged onto MANAGER. SYS to use this command. 

In a single-host environment, hostid need not be specified. In a multi-host environment, a hostid should 
be assigned to each host. When a hostid is not assigned to a particular host, that host automatically 
becomes the default host. Establishing a default host in a multi-host environment can result in users 
erroneously sending jobs to the default host, because they failed to specify a host ID prior to using the 
SUBMIT command. 

Paranneter 

hostid Used primarily in multi-host environments. This parameter can consist of 

up to eight alphanumeric characters. If several host systems are defined, 
each hostid must have a unique first character. 



Using New 

The first step in MRJE/3000 operation is to create at least one set of MRJE/3000 management files for 
each communication line between the HP 3 000 and each host. The NEW command is used to create these 
files. 

When hostid is omitted from the NEW command, MRJE/3000 assumes files are being built for the 
default host system. These files are named MRJECON, MRJEJOB, and MRJEDIR, to indicate their 
association with the default system. 



NOTE 



Use this command when logged on as MANAGER .SYS, PUB. The 
Configuration, Job Log, and Directory Files are created in the logon group 
and account. These files are useless unless they are in PUB. SYS. 

If several communications lines are connected at least one set of management files must be built for each. 
Care should be taken to avoid using host ID's with identical first characters. MRJE/3000 appends the 
first character of each host ID to MRJECON, MRJEJOB, and MRJEDIR to form unique names for each 
set of files. For example, if hostid is iLM2, the files for that host system are named MRJECONP, 
MRJEJOBf, and MRJEDIRi. When NEW executes, some items in the Configuration File are initialized 
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with the default values shown in Appendix A, Configuration File Contents. Other items are initialized 
with information provided by the MRJE/3000 Manager. 

After entering the NEW command, the Manager receives these prompting messages: 

MAXIMUM NUMBER OF JOBLOG ENTRIES = 1000 
NEW VALUE = 

Enter a value, 25 to 1000. The Job Log File is created to accommodate the number of specified 

entries. A carriage return retains the 1 000 value. 



NOTE 



A large Job Log File increases search time, and therefore response time. A 
small Job Log File requires frequent purging. 



HOST MACHINE = 

Enter an alphanumeric name up to eight characters in length. If hostid was included in the NEW 
command, enter that name. For the default host system, enter any name. 

PSEUDO CONSOLE DEVICE = 

Enter the logical device number that was assigned to the pseudo console during MPE configuration 
for Unit 2, driver lOMCONSO. See Appendix C, Configuring MPE to Include MRJE/3000. 

PSEUDO LINE MONITOR DEVICE = 

Enter the logical device number that was assigned to the first line monitor for Unit 0, driver 
lOMRJEO. See Appendix C, Configuring MPE to Include MRJE/3000. 

SIGNON CARD IMAGE = 

The format of a signon card is determined by host system personnel. Enter the response exactly as 
they specify. 

HOST SYSTEM = 

Respond HASP, JES2, JES3, ASP, or RSCS as appropriate. 

USER HOST COMMAND = 

Users can send one or more host console commands to the current host system while the line is 
active. The response to this prompt establishes which commands can be used. For example, if the 
manager enters $D, Users can enter all host console commands that begin with $D. If $DA is 
entered, which is a unique command, Users are limited to only that command. Be sure to enter a 
valid response. MRJE/3000 does not check whether your entry is valid. If you make a mistake 
here, MRJE/3000 Users receive an error message when they attempt to issue host console 
commands. 

PHONE NUMBER IN MRJECONTROL START COMMAND = 

This number appears in a dial message on the HP3000 terminal at which the :MRJECONTROL 
START command is entered. Unlike the previous prompts, a reply here is optional. To omit a 
telephone number, press [RETURN] . 

[CONTROLl Y can be used to terminate the NEW command at any time in the dialogue. However, if it is 
entered before the phone number prompt message, no new files are created and all information supplied 
up to that point is lost. 
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If the Configuration, Job Log, and Directory Files for a given host system already exist when this 
command is used, they are purged and rebuilt. 



NOTE 



This command does not affect files MRJEMSG^, the Message File; 
MRJESTR/z, the Stream File; MRJEFRM/i, the Form File; MRJECAT, the 
Message Catalog File; or MRJETABL, the Output Management File. 
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Purges entries from a Job Log File. 



Syntax 



p[uRGE] {^|;:^f^^^} 



Parameters 

OLDJOBS 



ALL 



Purges entries for cancelled jobs and jobs that have timed -out. A timed -out 
job has been in the Job Log File for a period of time, equal to or greater 
than the time limit configured in item 42 of the Configuration File. The 
time limit is measured from the point of successful transmission to the host. 

This parameter also causes entries for jobs that were transmitted to the host 
but were not acknowledged as having been received to be purged. 

Purges all entries from a Job Log File. An MRJE/3000 Manager can use 
this parameter only while logged as MANAGER . SYS , PUB. 



Using Purge 

Use ALL to empty the Job Log File. If any entries exist for jobs other than OLDJOBS, MRJE/3000 prints 
the warning message: 

M JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES" 
where n is a number. 

The purge request must be confirmed with a YES response. A Y response, or any other response causes the 
PURGE command to be ignored. 
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Example 

This example shows the purging of all jobs, both active and inactive. The HOST command was issued 
before purging, to be sure the command would reference the correct set of files. 

:HRJ£ 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

#HOST PLN2 

PLM2 IS THE CURRENT HOST MACHINE 

#PURGE ALL 

6 JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES" 

III 

MRJEJOBP COMPLETELY PURGED. 

In this example, only old jobs are purged: 



#HOST 

DEFAULT HOST ASSUMED 

PLM IS THE CURRENT HOST MACHINE 

#PUf?GE OLDJOBS 

MRJEJOB 10 JOBLOG ENTRIES CLEARED. 25 FREE ENTRIES NOW EXIST. 
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A TYPICAL MANAGER'S SESSION 

In the following example, the MRJE/3000 Manager builds a Configuration file, submits a job, displays the 
job's status, exits MRJE/3000, and exits MPE. 

: HELLO MANAGER. SYS 

HP3000 / MPE IV.C.B1.A2 (EREHWON) FRI, JUN 15, 1984, 10:40 AM 

:Nf?JE 

HP30249A.54.00 MRJE/3000 HEWLETT-PACKARD CO. 1984 

MANAGER CAPABILITY IN EFFECT 

#NEW 

DEFAULT HOST ASSUMED 

MAXIMUM NUMBER OF JOBLOG ENTRIES=100 

NEW VALUE= 

FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 

HOST MACHINE= 

MFRM 

PSEUDO CONSOLE DEVICE= 

112 

PSEUDO LINE MONITOR DEVICE= 

110 

SIGNON CARD IMAGE= 

/*SICNON REH0TE31 PASSWORD 

HOST SYSTEM= 

JES2 

USER HOST COMMAND= 

$DA 

PHONE NUMBER IN MRJE CONTROL START COMMAND= 

408-259-2442 

MFRM FILES CREATED 

#SUBMIT IBMJ0B1 

J0B#=1 J0BNAME=RJEDEM01 RECORDS READ=14 RECORDS WRITTEN=14 

MFRM IS OFF LINE 

IDISPLAY 1 

--JOB # 1 JOBNAME=RJEDEMO USER=JIM.DCA,WILLITS 

PRINT="LP" PUNCH="LP" FORMS="LP" 

WAITING TRANSMISSION TO HOST 
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Assume an MRJECONTROL START command is issued now, and the communications line to the default 
host, MFRM, is successfully opened. The Manager displays Job 1 again and then leaves MRJE/3000. 

*p|||pj||g::i||j: 

--J0i#=T J0BNAME=RJEDEM01 USER=JIM. DCA,WILLITS 

PRINT="LP" PUNCH="LP" FORMS="LP" 

TRANSMITTED TO HOST FRI, JUN 15, 1984, 11:03 AM HOST#=4340 
$DJ4340 HOST DISPLAY COMMAND SENT 
$11.04.30 JOB 4340 RJEDEM01 EXECUTING PRIG 6 

#1111 

CPU=3. C0NNECT=17. FRI, JUN 15, 1984 
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HOST CONSOLE COMMANDS 

The MRJE/3000 Manager has access to all host console commands that are available at remote host 
consoles. The MRJE/3000 Manager is responsible for determining which of the remote console 
commands to make available to all MRJE/3000 Users. By entering a specific symbol or symbols in the 
Configuration File, the Manager defines which commands the MRJE/3000 User can employ. 

Host console commands: 

• May be issued interactively while the communications line is connected. 

• May be issued as part of an IBM JCL deck. 

• Must conform to the format and restrictions of the host system. 

• Are refused, when issued interactively, if any other MRJE/3000 User is currently communicating with 
the host system. 

Once a MRJE/3000 Manager issues a host console command. Console Command Mode is in effect. 
Console Command Mode remains in force until that Manager issues a [CONTROD Y to return the session to 
MRJE/3000 command mode. No MRJE/3000 prompts are issued. Everything entered is transmitted to 
the host as a console command. When the Manager is in Console Command Mode, MRJE/3000 does not 
transmit host console commands that are entered by any other user. 

Output from the host console is unpredictable because it depends on host system activity. Usually a host 
console command generates a response at the Manager's terminal. If the terminal falls behind in printing 
this response, some host console output can be lost, unless MRJE/3000 console logging, described in this 
section, is operating. 

The Manager can exit console command mode at any time by entering [CONTROD Y. which returns the session 
to MRJE/3000 command mode. 

Example 

In this example, the MRJE/3000 Manager uses the JES2 host console command $DA to display those 
jobs that are currently active at the host. This initiates Console Command Mode. 

^^iii Enter Console Command Mode. 

$15.33.04 JOB 388 JOB0A31 EXECUTING PRIO 6 

$15.33.04 JOB 390 JOB0A32 EXECUTING PRIO 6 

$15.33.04 JOB 392 JOB0A33 EXECUTING PRIO 6 

Still in Console Command Mode. 



ICONTROp il 

# • ♦ • Returned to MRJE/3000 Command mode. 



4-40 



MANAGING MRJE/3000 
HOST CONSOLE MESSAGE LOGGING FACILITY 

MRJE/3000 can log all host console messages to a Message File, an optional file. Host console message 
logging does not interfere with normal console operation. Message Files must be built or defined for each 
host. Message Files, MRJEMSG/i, are described in this section. 

PERFORMANCE MEASUREMENT 



A limited performance measurement facility is provided through the use of the Host Console Message 
Logging Facility in an MRJEMSG/z file. This facility measures the turn around time for host job output 
received by MRJE/3000. In addition, output from host jobs can be located by searching through this file 
for a performance measurement record. A record is written in the MRJEMSG/z file for each job received. 
The format of the record is: 



Characters: 


Description: 


3-6 


Job Number 


9-16 


Job Name 


22-29 


Start receiving time, hh:mm:ss. 


35-42 


End receiving time, hh : mm : ss. 


39-54 


Total time in seconds. 


61-68 


Number of characters received. 


74-80 


Number of records received. 
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CAUSES OF UNSOLICITED OUTPUT 

If MRJE/3000 receives output from the host that is not directed, is unsolicited, it can be because: 

• The output has been directed to an unsolicited output device through this kind of a submit command: 

#SUBMIT ... ;PRINT=0 

• The host or another remote station has routed data to your station. 

• MRJE/3000 was not able to interpret the print or punch banners because they are not standard: that is, 
they do not conform to the default Configuration File parameters for banners. See Building Files for 
MRJE/3000 Management in this section, and Appendix A, Configuration File Contents, for 
information on MRJE/3000 recognition of banners. 

• MRJE/3000 can't read the host console ON message because: 
Items 15-17 in the Configuration File did not match the message. 
The host does not send an ON message upon receipt of jobs. 

• There was a significant lag between the time the host received a job and the time the host returned 
output to MRJE/3000. During this lag, the contents of the Joblog File, including output routing 
information for your job, were purged. 

• You have suppressed printing or punching of banners. This took place in your JCL, or by means of a 
host console command. 
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CONTROLLING UNSOLICITED OUTPUT 



If the host is waiting to transmit output to MRJE/3000 and you know that output will be treated by 
MRJE/3000 as unsolicited, you may still direct it to a specific destination file. Use one of these methods: 

1. SPOOK: 

Raise Outfence on the MPE Spooler. 

Receive output at the Spooler. 

Use the MPE utility SPOOK to COPY the output data set to another disc file, or 
OUTPUT the data set to tape. 

2. A disc file: 

Build a large disc file in PUB. SYS for print or punch output. This could be an MSG 
file, depending on the type of output you expect. Include the carriage control 
character in recsize count, and also specify CCTL. 

Specify the name of the disc file in Items 21-27, unsolicited print disposition, or 
Items 29-35, unsolicited punch disposition, in the Configuration File. 

3. Output Management: 

Define FORMIDs for items 21-27, unsolicited print disposition, or items 29 - 35, 
unsolicited punch disposition, with corresponding entries in file MRJETABL. PUB. SYS. 
See Output Management. 

4. Global File Equation: 

Define deferred output spool files within the Stream File MRJESTR/i for each 
configured pseudo printer and punch before communication with the host system is 
initiated, and modify items 21 - 27, unsolicited print disposition, and 29 - 35, 
unsolicited punch disposition, to refer to these files. 

:FILE UNSLPR1 ;DEV=LP,1 
:FILE X=X,OLD;DEV=DISC 

Alter the unsolicited output items of the Configuration file, items 21-27 for 
printers and 29-35 for punches, to refer to the files defined in the step above. For 
example, alter item 21, unsolicited printer disposition for printer 1, to the value 
! UNSLPR1 for low priority line printer output, or !X for disc output -- File X must 
exist -- then, initiate communication with the host system using an 
MRJECONTROL START statement. The 

5. MRJE/3000: 

Revise MRJE/3000 Configuration File parameters to conform to the output 
destination you want. 
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COMMUNCATIONS LINK 



SECTION 



INTRODUCTION 

An MRJE/3000 Console Operator controls the communcations link. A Console Operator 

• Opens and closes the MRJE/3000 communications link with a host, 

• Changes the number in the transmission error retry counter parameter, 

• Turns on and off the CS trace diagnostic facility, 

• Checks the version update and fix levels of MRJE/3000 software, 

• Verifies the contents of the Output Management table, MRJETABL. 

DESIGNATING AN MRJE/3000 CONSOLE OPERATOR 

Any MRJE/3000 User who has been authorized by the HP 3000 system console operator to use the 
MRJECONTROL commands of MPE can carry out the MRJE/3000 Console Operator functions. Use is 
authorized by means of the ALLOW command, as described in MPE Commands Reference Manual. The 
format of ALLOW command is: 

ALLOW wser.acci ;COMMANDS=MRJECONTROL 
MRJECONTROL commands are summarized in Table 5-1. 
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Table 5-1. MR JECONTROL Commands 



COMMAND SYNTAX 


FUNCTION 


MRJECONTROL START [,hostid] 
[; trace function] 


Used to open a communications link, initiate 
transmission over the link, turn on the CS TRACE 
facility. 


MRJECONTROL SIGNOFF [,hostid] 


Used to close the communications link in an 
orderly fashion. A /*SIGNOFF is sent to the host. 


MRJECONTROL KILL [,hostid] 


Used to close communications link immediately 
and in an unorderly fashion, without "SIGNOFF". 


MRJECONTROL RETRIES, [hostid] , retrynum 


Used to set a limit on the number of times 
MRJE/3000 requests re-transmission of block of 
data not received successfully from host. 


MRJECONTROL TRACE, [hostid] , ON 
[trace options] 


Used to activate the CS communications link trace 
facility. 


MRJECONTROL TRACE, [hostid] , OFF 


Used to deactivate the CS communications link 
trace facility. 


MRJECONTROL CHECK 


Used to check the version, update and fix levels of 
the MRJE/3000 software currently on your 
system. 


MRJECONTROL VERIFY 


Used to verify that each record in the lookup table 
MRJETABL represents a valid file equation 
record. 
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Opens communications link and can initiate communications tracing. 



Syntax 



MRJECONTROL START [,hostid] [\trace function] 



Parameters 

hostid 

trace function 



trace options 



Requests connection to system identified by hostid. 



TRACE 



/ON 
' \OFF 



ON [trace options] 



} 



TRACE, ON turns on CS tracing with the parameter list indicated in trace 
options. These parameters are described with MRJECONTROL TRACE in 

this section. 

[,[ALL] [Amask] [, [/iw/??ewir£es] [, [WRAP] [^filename] ]]]] 

These parameters are described with MRJECONTROL TRACE in this 
section. 



Discussion 

Use an MRJECONTROL START command to open the communication line to a host and to initiate 
transmission over the line. The CS TRACE diagnostic may also be activated at this time. For more 
information on CS TRACE, see MRJECONTROL TRACE, in this section. 

Contact your Hewlett-Packard representative to find out the most appropriate way to use the trace 
function. 

Prior to issuing an MRJECONTROL START check to see if the stream file exists for the hostid. The 
stream file is named MRJESTR/i. PUB. SYS, where h is the host identification character. An 
MRJECONTROL START command causes a corresponding MRJESTR/?. PUB.SYS file to be streamed. 
Each host identifier must have its own stream file. 
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Sample Stream File 

Use EDIT/ 3000 or TDP to create a stream file. This is a sample stream file for a default host: 

!JOB MANAGER. SYS ;HIPRI;RESTART;TIME=? 

♦COMMENT 

tCOMMENT Although Output Management is preferred, 

tCOMMENT this allows users to route output to 

ICOMMENT an HP2680 with a specific environment. 

♦FILE ELITE;DEV=LPS;ENV=ELITE.HPENV.SYS 

! COMMENT 

tCOMMENT Although Output Management is preferred, 

tCOMMENT this allows users to route output to 

tCOMMENT a file that will be deferred. 

tFILE H0LDLP;DEV=LP,1 

tCOMMENT 

tCOMMENT This establishes the Message File. 

tCOMMENT It records console message output 

tCOMMENT on $STDLIST. 

tFILE MRJEMSG=$STDLIST 

tCOMMENT 

tCOMMENT The stack dump facility is armed to 

tCOMMENT operate when an MRJEMON problem occurs. 

tSETDUMP DB,ST 

tRUN MRJEMON ;INFO=" " 

tEOJ 

Access to stream files like the one above should be limited to their creator by using the MPE command 
ALTSEC, as described in the MPE Commands Reference Manual 

Opening a Communcations Line 

If communications are on a private (leased) line, or on a switched line with an auto -dial capability, 
connection occurs shortly after the MRJECONTROL START command is issued, and a message is received at 
the HP 3 000 master console like the following 

10:51/24/MRJE: SIGNON COMPLETED 

If the communication link is a switched line without auto -dialing, a message similar to the following is 
printed at the HP 3 000 master console after MRJECONTROL START is issued: 

10:55/24/MRJE: DIAL REMOTE 408-259-2442 

The telephone number printed in this message is item 39 of the Configuration File. 
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If the MRJECONTROL START command includes hostid, the first character of the hostid is appended to 
"MRJE" in the console message. For example, if the hostid is BRUNO, then an MRJECONTROL START 
command is: 

: MRJECONTROL STAf?T,B 
and the console message for switched Unes without auto-dialing is similar to the following: 

11 :03/24/MRJE|: DIAL REMOTE 408-259-2442 
Following the display of this console message, the MRJE/ 3 000 Console Operator should: 

1. Place the call at the dial-up modem telephone. 

2. Listen for the answer carrier tone. 

3. Press the DATA button, if the modem so requires, when the answer tone becomes audible. 

4. Check the system console terminal for a message similar to the following: 

10:51/24/MRJEi: SIGNON COMPLETED 

5. If the readers, printers, and punches for your remote station have been drained at the host 
system, start those you need with host system console commands. A drained device at the host is 
like a downed device on an HP3000. 

Once the communications link has been established: 

• MRJE/ 3 000 automatically transmits jobs to the host system and routes output from the host system to 
the designated HP 3 000 output files. 

• MRJE/ 3000 Users, working at their terminals, can transmit host system console commands and receive 
responses from the host system. 

• The MRJE/ 3 000 Manager, if working at a terminal, can monitor host system activity. 

• The MRJE/ 3 000 Console Operator if working at a terminal can monitor for MRJE/ 3 000 messages. 

Each time the MRJECONTROL START command is issued, MRJE/3000 checks whether the correct 
MRJE/3000 modules are installed. If version or update levels do not match among modules, the following 
message is issued: 

INCOMPATIBLE MRJE MODULES 

The MRJECONTROL CHECK command should then be entered to identify the incorrect module. 
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Closes a communications link in a systematic fashion. 

Syntax 



MRJECONTROL SIGNOFF [,hostid] 



Parameter 

host id Initiates systematic closing of line to host system identified by hostid. The 

default is to close the default host system. 



Discussion 

After the command has been issued, MRJE/3000 may print one of these messages: 

CS WARNING 103 

OS WARNING 207 

MRJE TERMINATING 

This depends on the host system configuration. Although the message can normally be ignored, the 
MRJE/3000 Manager may occasionally ask for the warning number. 

MRJE/3000 communicating with JES2 work stations prints: 

MRJE TERMINATING 

When the MRJECONTROL SIGNOFF command is entered, any currently active readers finish 
transmitting before the command takes effect. 

If an MRJECONTROL SIGNOFF command is issued while a file is being transmitted to or from the host 
system, transmission continues until all of the file has been sent. Then the line is disconnected. In this 
way no data is lost. 

RSCS Restriction 

Do not use this command with an RSCS job entry system on a switched line. After making sure that 
transmission between the HP 3 000 and the host are completed, always use MRJECONTROL KILL instead. 
RSCS automatically deactivates a line upon signoff. Host system operations must intervene to reactivate 
the line for any subsequent SIGNON if you use MRJECONTROL SIGNOFF. 
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MRJECONTROL KILL 

Causes all communication with the host system to halt immediately. 

Syntax 



MRJECONTROL KILL [,hostid] 



Parameter 

host id Identifies the host system where all communication is to cease immediately. 

The default value is the default host system. 



Discussion 

Occasionally, an emergency may occur, a SIGNOFF command may fail to produce the MRJE 
TERMINATING message, or a dial-up Hne may be busy-making it necessary to terminate the subsystem 
abnormally with the KILL command. 



CAUTION 



The command MRJECONTROL KILL should be used in emergencies only, 
except with RSCS, because error free recovery from the command is not 
certain. 

Following an MRJECONTROL KILL command, it may be necessary to enter the 
MRJECONTROL START command several times. If repeated attempts to make the connection fail, 
consult with the host system operator. 

RSCS Exception 

Use this command to terminate a session with a host with an RSCS job entry system on a switched line. 

Make certain that transmission between the HP 3 000 and the host are completed. Do not use 
MRJECONTROL SIGNOFF. 
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Regulates the MRJE/3000 driver. 



Syntax 



MRJECONTROL RETRIES, [hostid] , retrynum 



Parameters 

host id 
retrynum 



Is the name by which the host system is identified. If this parameter is not 
used, MRJE/3000 assumes the default host system is intended. 



Is an integer between 1 and 255, inclusive 
The initial value depends on the 
configured. 



This parameter is required. 

communications controller being 



Discussion 

You can regulate the number of times MRJE/3000 repeats its attempt to receive a block of data from the 
host system. Transmission errors may be occurring because of a dirty communications line. Issue the 
command MRJECONTROL RETRIES from MPE. You can issue this command anytime the line is active. 



CAUTiON 



Since this command adjusts a communications driver retry counter, its use 
could affect processing speed and system performance. 
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Enables and disables communications link tracing. 



Syntax 



p, , . /I fON [trace options]\ 
MRJECONTROL TRACE, [hosttd] A]^^^^ ^ ^> 



Parameters 

host id 

ON 

OFF 

trace options 

ALL 

mask 



Is the name by which the host system is identified. If this parameter is 
omitted, MRJE/3000 assumes the default host system is intended. 

Keyword used to initiate tracing. 

Keyword used to terminate tracing. 

[,[ALL] [Arnask] [Ai^i^nientries] [, [WRAP] [.filename] ]]]] 

A keyword; when present tracing generates a record of all transmission 
activity. When omitted, trace records are written only when transmission 
errors occur. 

Is an octal number preceded by a percent symbol that specifies the type of 
events to trace. Use the default mask, %37, unless your Hewlett-Packard 
representative recommends another value. The values of mask are: 

BIT Meaning when on: 

Not used for MRJE/3000. Most significant. 

1 INP interconnect entries. Not used for MRJE/3000. 

2 PSTN entries. Default=OFF. 

3 POPR and PEDT entries. Default=ON. 

4 PRCT entries. Default=ON. 

5 PRTX entries. Default=ON. 

6 PSCT, PPOL, PSEL entries. Default=ON. 

7 PSTX entries. Default=ON. Least significant. 



NOTE 



INP interconnect and PSTN (state transition) 
entries should not be traced except at the 
request of your Hewlett-Packard 
representative. This generates many trace 
entries. 
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numentries 



Is the number of entries per record. (Default is 24. Maximum is 248.) For 
an INP use 24. 



WRAP 



filename 



A keyword, when present causes trace entries that overflow the trace record 
(that exceed numentries) to overlay the first entries written to that record. 
If omitted, the overflow entries are discarded. 

This parameter is applied to entries within records, not records within files. 
If trace records overflow a trace file, CS TRACE automatically starts 
writing them over the first records in the file. 

Is the name of the file where the trace records are to be stored. If this 
parameter is omitted, CS TRACE creates file in MRJETRC/?. PUB.SYS with 
the name, where h is the first character of the host system ID. If another 
file is used, it must be identified or built before executing 
MRJECONTROL TRACE. 



Discussion 

The CS TRACE facility can be enabled by an MRJECONTROL TRACE, or MRJECONTROL START 
command. Contact your Hewlett-Packard representative to find out the most appropriate way to use this 
command. This command can be entered any time the line is open. 

Listing Trace File Contents 

The CS TRACE dump utility program CSDUMP. PUB. SYS can be used to format and print the contents of 
trace files generated by the trace facility. An example of the commands required to list the files to a line 
printer is: 



FILE CSTRACE=filename 

FILE LIST;DEV=LP 

RUN CSDUMP. PUB. SYS[, HEX] 



"LP", or other designation for "printer" 



where filename is the name of the trace output file name specified in the MRJECONTROL TRACE or 
MJRECONTROL START command. If no trace output filename was specified there, use 
MRJETRC/7.PUB.SYS,, where h is the host system identification. The secondary entry point 
CSDUMP. PUB.SYS,//f fallows raw data to be output in hexadecimal 

Contact your Hewlett-Packard representative for assistance in interpreting trace file contents. 
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MRJECONTROL CHECK 

Checks the version, update, and fix levels of each MRJE/3000 module. 

Syntax 



MRJECONTROL CHECK 



Discussion 

This command has no parameters. The MRJECONTROL CHECK command can be used to check the 
version, update and fix levels of each MRJE/3000 module. This can be particularly useful in verifying the 
correct installation of MRJE. 

When the command is issued, a table showing each MRJE/3000 module and its levels of revision is printed 
at the user's terminal. The format of the table is as follows: 

MODULE VERSION 

(REVISION) 

MRJEMISC1/2 V.UU.FF 

MRJE V.UV.FF 

MRJEMON V.UU.FF 

MRJEOUT V.UU.FF 

MRJELOGR V.UU.FF 

lOMPNLPO V.UU.FF 

lOMCONSO V.UU.FF 

lOMRDRO V.UU.FF 

lOMRJEO V.UU.FF 

I0MRJE1 V.UU.FF 

V , UU y and FF are integers. V stands for version, UU for update, and FF for fix. If a module is not 
present in the system, the following message is printed in place of V .UU. FF: 

*UNABLE TO ACCESS MODULE* 

If a module is present but no revision levels can be determined, the following message is printed in place 
of V.UU.FF 

*N0 VERSION LEVEL* 

Each time the MRJECONTROL START command is issued, MRJE/3000 checks whether the correct 
MRJE/3000 modules are installed. If version or update levels do not match between modules, the 
following message is issued: 

INCOMPATIBLE MRJE MODULES 

The MRJECONTROL CHECK command should then be issued to identify the incorrect module. 
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MRJECONTROL VERIFY 

Determines that each record in the lookup table represents a valid file equation record. 

Syntax 




Discussion 

The MRJECONTROL VERIFY command can be used to verify that each record in the lookup table 
MRJETABL represents a valid file equation record. This example illustrates verification of a file with 1 2 
records: 

INJ^JECONTROL VEfilFY 

A dot is printed as a record is successfully verified. 

ALL RECORDS PASSED 

END OF PROGRAM 

For each record, MRJE/3000 programmatically issues a file equation using the file name TEST« where n 
is an integer from to 9999. MRJE/3000 then performs an FOPEN and an FCLOSE. If the output file is 
spooled, it is deleted. MRJE/3000 prints a dot ( .) on the screen as each record is successfully verified. 

If any records fail, then MRJE/3000 prints a COMMAND intrinsic failure message, or an FOPEN intrinsic 
failure message, and continues until all records have been tested. Upon testing the last record, 
MRJE/3000 prints the following message on the screen instead of the ALL RECORDS PASSED message: 

N RECORD(S) FAILED 

An MRJECONTROL VERIFY command may be interrupted with [BREAKI as well as with [COWTROLl Y. 

See Output Management in Section 4, Managing MRJE/3000, for additional information on the use of 
MRJETABL. 



NOTE 



This command can only verify MRJETABL. PUB. SYS. If you identify 
another lookup table by using a FILE statement in MRJESTR/?. PUB.SYS, 
this command fails. 
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MRJE/3000 TROUBLESHOOTING AND 
INFORMATION MESSAGES 



SECTION 



MRJE/3000 troubleshooting tools described in this section are: 

• Error Message Logging; 

• DBUG and DBUGLINES entry points into MRJEMON; 

MRJE/3000 information messages sent to Users, Managers, and the HP3000 system console are included 
with an interpretation and, when applicable, a suggested corrective action. 

ERROR MESSAGE LOGGING 

MRJE/3000 keeps a log of all error messages by printing them to the SSTDLIST device of the monitor 
process. An MRJECONTROL START,/? command from MPE streams file MRJEJESTR^z.PUB.SYS to initiate 
the MRJE/3000 monitor process MRJEMON. If a file system error occurs, MRJE/3000 calls 
PRINT'FILE'INFO, an intrinsic which lists a file system information display on the SSTDLIST device, and 
also sends a message the HP 3 000 console. Other information listed on the SSTDLIST device includes the 
contents of MRJETABL and MRJE/3000 version numbers. 

This information is always listed on the SSTDLIST device: 

• MRJE/3000 Module Version Numbers. 

• Contents of MRJETABL if it exists. 

• All messages sent to the HP 3 000 console. 

• PRINT'FILE'INFO line information display for all file system errors. 
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THE DBUG ENTRY POINT 



The DBUG entry point into MRJEMON causes the output process for PRINTER 1 to perform an internal 
trace of all activity and lists this information onto $STDLIST. In addition, the MRJELOGR process, 
which monitors all messages sent to the remote console, lists any setup messages sent by the host. 



NOTE 



DBUG-related tracing can be enabled for the Printer 1 process only (MRJE 
Configuration File Item #21). Error messages, however, are reported by the 
other MRJE processes to $STDLIST as necessary. 

To gain maximum benefit from this facility, all output devices other than 
Printer 1 should be DRAINED at the host system. This limits the 
possibility of error messages from other processes being interleaved with 
Printer 1 tracing. Also, all host output should be directed to Printer 1. 
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This example shows a Stream File for the default host. Notice the DBUG entry point used to activate 
tracing. 

! JOB MRJEMON ,MANAGER/passiJorc^. SYS , PUB 
♦RUN MRJEMON,OBUG;INFO=" " 

Do not confuse the liBUO entry point with a DEBUG run command parameter. 

This is a typical DBUG internal tracing output for hostid N : 



:JOB Mf?JEMONN, MANAGER. SVS, PUB 

PRIORITY = DS; INPRI = 8; TIME = UNLIMITED SECONDS 

JOB NUMBER = #J2 

THU, MAY 3, 1984, 3:15 PM 

HP3000 / MPE V G.00.00 (BASE G.00.00). 

COMMENT **** FILE EQUATIONS SET: 

FILE T;DEV=TAPE 

FILE LP;DEV=LP 

FILE LIST;DEV=LP,2 

:Rm Nf?JEMON,OBUG;INFO="n" 



Logon UDC output. 



MODULE 
MRJEMISC1/2 
MRJE 
MRJEMON 
MRJEOUT 
MRJELOGR 
lOMPNLPO 
lOMCONSO 
lOMRDRO 
lOMRJEO 
I0MRJE1 



VERSION 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 
A. 54. 00 



MRJETABL contents : 



STD. 

12 

LP602 

13 

14 

15 

17 

BAD 

110 

18 

19 

##^@ 

$#$@@< 

LONG 

LONGNAME 

HOST 

16 

11 



m 



;DEV=PP;ENV=LP602. HPENV 

;ACC=OUT;DEV=EPOC,4,2;ENV=LPLONG.HPENV 

;DEV=LPS,2;ENV=LP602.HPENV 

;DEV=EPOC,5,3;ENV=LP604.HPENV 

;DEV=PP,3,4;ENV=PICA2.HPENV 

;ACC=OUT;DEV=LPS,,5;ENV=LP60LONG.HPENV 

;DEV=EPOC,4,7;ENV=LP60LONG.HPENV 

;DEV=NOTTHERE;ENV=ELITE. HPENV 

;DEV=EPOC,,10 

=DISC. MRJE. SYS, OLD 

=DISC2. MRJE. SYS, NEW; ACC=OUT;NOCCTL 

;DEV=LP,3;F0RMS=CHECKS. 

;DEV=PP;ENV=LP2BAR.HPENV»SYS 

;DEV=LPS,7;ENV=LP602.HPENV 

;DEV=PP;ENV=LP604. HPENV 

;DEV=LPS;ENV=LP60L0NG. HPENV 

;DEV=LP,3 

;DEV=PP,,11 
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NEW ; DEV=EPOC ,2,9; ENV=LP2BAR . HPENV 

TEST =SPECIAL;DEV=PP,3;F0RMS=SPECIAL. 

End of MRJETABL 

MRJE (N) SIGNON COMPLETED 

BEGIN TRACING FOR PRINTER 1 

DEFAULT SOLICITED OUTPUT DESTINATION = 'STD. ' 

DEFAULT UNSOLICITED OUTPUT DESTINATION = 'STD. ' 

CURRENT FORM = 12 This value came from MRJE FRMN. 

A SETUP message was detected prior to receiving the first dataset: 

15.24.53 JOB 120 $HASP190 I SETUP -- R9.PR1 -- F = STD. -- C = 6 

Use form STD. for job I. 

FILE EQUATION ISSUED BY PRINTER 1: 
FILE I ;DEV=PP;ENV=LP602. HPENV 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB I 
HOST JOB NUMBER = 120 
EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #030 The MPE Spoolfile is ^030. 

PRINT = 'STD.' FORMS = 'STD.' PRINT and FORMS values are from 

CURRENT FORM = STD. the MRJE/ 3000 Job Log. Form 

STD . is now on the printer. 



+-F-I-L-E---I-N-F-0-R-M-A-T-I-0-N---D-I-S-P-L-A-Y+ 

! FILE NAME IS I 

FOPTIONS: NEW, ASCII , FORMAL, U,CCTL,FEQ,NOLABEL 
AOPTIONS: OUTPUT, NOMR, LOCK, SHR,BUF,NOMULTI 
WAIT,NOCOPY 



DEVICE TYPE: 32 



LDEV: 5 

RECORD SIZE: 134 
EXTENT SIZE: 
RECPTR: 61 
LOGCOUNT: 61 
EOF AT: 
FILE CODE: 



DEVICE SUBTYPE: 
DRT: UNIT: 

BLOCK SIZE: 136 (BYTES) 
MAX EXTENTS: 
RECLIMIT: 

PHYSCOUNT: 61 
LABEL ADDR: %00500000000 
ID IS ULABELS: 



PHYSICAL STATUS: ???????????????? 

ERROR NUMBER: 85 RESIDUE: 18 (BYTES) 

BLOCK NUMBER: 61 NUMREC: 1 

+ + 

OUTPUT FILE FOR JOB I SUCCESSFULLY CLOSED 



The PRINT'FILE'INFO 
intrinsic produces 
a file information 
display. 



Another SETUP message received; Job 18 requires form 18: 
15.25.17 JOB 121 $HASP190 18 SETUP -- R9.PR1 



- F 



18 



-- C = 6 
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FILE EQUATION ISSUED BY PRINTER 1: The FOPEN of this file failed. 

FILE 18 =DISC.MRJE.SYS,OLD 

MRJE(N) ERR135: MRJEOUT, OPEN FAILURE (52) ON MRJEOUT 
NONEXISTENT PERMANENT FILE (FSERR 52) 



+-F-I-L-E---I-N-F-0-R- 
? ERROR NUMBER: 52 

! BLOCK NUMBER: 

+ 



I-A-T-I-0-N---D-I-S-P-L-A-Y+ 
RESIDUE: ? 

NUMREC: ! 

+ 



The next five lines duplicate console error messages. 

MRJE FORMID = IB 

MRJE (N) The following file equation was attempted 

FILE IB =DISC.MRJE.SYS,OLD 

MRJE Used default FORMID of STD. for job IB 

MRJE (N) Used output priority of 2. 

MRJE/3000 tries again using the standard form. 

FILE EQUATION ISSUED BY PRINTER 1: 

FILE IB ;DEV=PP;ENV=LP602.HPENV 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB IB 

HOST JOB NUMBER =121 

EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #032 

PRINT = 'STD.' FORMS = 'STD.' 

CURRENT FORM = IB 



•F-I-L-E---I-N-F-0-R-M-A-T-I-0-N---D-I-S-P-L-A-Y+ 
FILE NAME IS IB 

PORTIONS: NEW, ASCII , FORMAL, U,CCTL,FEQ,NOLABEL 
AOPTIONS: OUTPUT, NOMR, LOCK, SHR,BUF,NOMULTI 
WAIT,NOCOPY 



DEVICE TYPE: 32 
LDEV: 4 DRT: 
RECORD SIZE: 134 
EXTENT SIZE: 
RECPTR: 61 
LOGCOUNT: 61 
EOF AT: 
FILE CODE: 
PHYSICAL STATUS: 
ERROR NUMBER: 85 
BLOCK NUMBER: 61 



DEVICE SUBTYPE: 
UNIT: 
BLOCK SIZE: 136 (BYTES) 
MAX EXTENTS: 
RECLIMIT: 

PHYSCOUNT: 61 
LABEL ADDR: %00400000000 
ID IS ULABELS: 

???????????????? 

RESIDUE: 18 (BYTES) 
NUMREC: 1 



OUTPUT FILE FOR JOB 18 SUCCESSFULLY CLOSED 
***»**»***********'»**4t*4f***4***^»«*****#**f ********* 



Another change of forms message is received. 

15.25.34 JOB 122 $HASP190 16 SETUP -- R9.PR1 



- F = 16 



C = 6 
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FILE EQUATION ISSUED BY PRINTER 1: 

FILE 16 ;DEV=LP,3 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB 16 

HOST JOB NUMBER = 122 

EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #033 

PRINT = 'STD.' FORMS = 'STD. ' 

CURRENT FORM = 16 



+-F-I-L-E---I-N-F-0-R-M-A-T-I-0-N---D-I-S-P-L-A-Y+ 
FILE NAME IS 16 

FOPTIONS: NEW, ASCII , FORMAL, U,CCTL,FEQ,NOLABEL 
AOPTIONS: OUTPUT, NOMR, LOCK, SHR, BUF,NOMULTI 
WAIT,NOCOPY 



DEVICE TYPE: 


32 


DEVICE SUBTYPE: 


LDEV: 4 


DRT: UNIT: 


RECORD SIZE: 


134 


BLOCK SIZE: 136 (BYTES) 


EXTENT SIZE: 





MAX EXTENTS: 


RECPTR: 1 




RECLIMIT: 


LOGCOUNT: 1 




PHYSCOUNT: 1 


EOF AT: 




LABEL ADDR: %00400000000 


FILE CODE: 




ID IS ULABELS: 


PHYSICAL STATUS: 


???????????????? 


ERROR NUMBER 


85 


RESIDUE: 


BLOCK NUMBER: 


1 


NUMREC: 1 



OUTPUT FILE FOR JOB 16 SUCCESSFULLY CLOSED 
15.25.46 JOB 123 $HASP190 14 SETUP -- R9.PR1 



-- F = 14 -- C = 6 



The file equation failed for this record. 

FILE EQUATION ISSUED BY PRINTER 1: 

FILE 14 ;DEV=NOTTHERE;ENV=ELITE.HPENV 

MRJE (N) Failure to execute MPE "COMMAND" Intrinsic 

UNKNOWN DEVICE CLASS. (CIERR 344) 

Command PARM = 3 

MRJE FORMID = BAD 

MRJE (N) The following file equation was attempted: 

FILE 14 ;DEV=NOTTHERE;ENV=ELITE.HPENV 

MRJE Used default FORMID of STD. for job 14 

MRJE (N) Used output priority of 2. 

Standard form is used. 

Notice that FORMS are routed to FORMID 'BAD': 

FILE EQUATION ISSUED BY PRINTER 1: 

FILE 14 ;DEV=PP;ENV=LP602.HPENV 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB 14 

HOST JOB NUMBER = 123 

EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #034 

PRINT = 'STD.' FORMS = 'BAD' 

CURRENT FORM = 14 
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F-I-L-E---I-N-F-0-R-M-A-T-I-0-N---D-I-S-P-L-A-Y+ 
FILE NAME IS 14 

FOPTIONS : NEW, ASCI I , FORMAL , U , CCTL ,FEQ, NOLABEL 
AOPTIONS : OUTPUT , NOMR , LOCK ,SHR , BUF , NOMULTI 
WAIT,NOCOPY 



DEVICE TYPE: 
LDEV: 4 
RECORD SIZE: 
EXTENT SIZE: 
RECPTR: 61 
LOGCOUNT: 61 
EOF AT: 
FILE CODE: 



32 DEVICE SUBTYPE: 0. 
DRT: UNIT: 
134 BLOCK SIZE: 136 (BYTES) 
MAX EXTENTS: 
RECLIMIT: 

PHYSCOUNT: 61 
LABEL ADDR: ^,00400000000 
ID IS ULABELS: 



PHYSICAL STATUS: ???????????????? 

ERROR NUMBER: 85 RESIDUE: 18 (BYTES) 

BLOCK NUMBER: 61 NUMREC: 1 
+ + 

OUTPUT FILE FOR JOB 14 SUCCESSFULLY CLOSED 



Another forms change is received: 

15.26.40 JOB 124 $HASP190 I SETUP -- R9.PR1 

Now all print output is routed to FORM ID 'TEST' : 

FILE EQUATION ISSUED BY PRINTER 1: 

FILE I =SPECIAL;DEV=PP,3;F0RMS=SPECIAL. 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB I 

HOST JOB NUMBER = 124 

EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #036 

PRINT = 'TEST' FORMS = 'STD. ' 

CURRENT FORM = STD. 

Now TEST defines an alternate file name for the output spoolfile. 



+-F-I-L-E---I-N-F-0-R-M-A-T-I-0-N---D-I-S-P-L-A-Y+ 

» FILE NAME IS SPECIAL 

FOPTIONS: NEW, ASCII , FORMAL, U, CCTL, FEQ, NOLABEL 
AOPTIONS : OUTPUT, NOMR , LOCK ,SHR , BUF , NOMULTI 
WAIT,NOCOPY 



F = STD. -- C = 6 



DEVICE TYPE: 32 


DEVICE SUBTYPE: 


LDEV: 4 DRT: UNIT: 


RECORD SIZE: 134 


BLOCK SIZE: 136 (BYTES) 


EXTENT SIZE: 


MAX EXTENTS: 


RECPTR: 1 


RECLIMIT: 


LOGCOUNT: 1 


PHYSCOUNT: 1 


EOF AT: 


LABEL ADDR: %00400000000 


FILE CODE: 


ID IS ULABELS: 


PHYSICAL STATUS: 


???????????????? 


ERROR NUMBER: 85 


RESIDUE: 7 (BYTES) 


BLOCK NUMBER: 1 


NUMREC: 1 
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OUTPUT FILE FOR JOB I SUCCESSFULLY CLOSED 

MRJE (N) FINAL TERMINAL SIGNOFF 
MRJE (N) MRJE TERMINATING. . . 
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THE DBUG'LINES ENTRY POINT 

The DBUG'LINES entry point to MRJEMON causes the Printer 1 output process to trace each line 
received from the host and Hst it to $STDLIST. ASCII carriage control information is displayed in octal 
in the first four positions, followed by a space, and then the record received. Transaction tracing enabled 
by the DBUG entry point is also enabled. 

Any unsupported carriage control command characters sent by the host are translated into single space 
controls by MRJE. Consult the MRJE/3000 Reference Manual for additional information on translation 
of carriage control information. The MPE Inthnsics Reference Manual describes how the FWRITE 
intrinsic uses carriage control values. 



NOTE 



As with the DBUG entry point, this level of tracing can be activated for 
Printer 1 only. 



To enable this level of internal tracing, modify the RUN MRJEMON command in the MRJESTR/z file: 

RUN MRJEMON, OBUC LINES; INFO= ... 

The DBUG'LINES entry point activates hne tracing for the Printer 1 process for the default host. 

This illustrates typical output received when DBUG'LINES tracing is enabled: 

MRJE (N) SIGNON COMPLETED 

BEGIN TRACING FOR PRINTER 1 

DEFAULT SOLICITED OUTPUT DESTINATION = 'STD. ' 

DEFAULT UNSOLICITED OUTPUT DESTINATION = /STD.' 

CURRENT FORM = 12 

The first line received is a carriage control to set post -space movement. 

%100 

The next line is sent to the remote console and is printed by MRJELOGR: 

22.21. ^\ JOB 159 $HASP190 15 SETUP -- R9.PR1 -- F = 15 -- C 

This line is the first banner line with single space CCTL: 

fo201 *A START JOB 159 15 0001 0001 R0009 MILES 

Since the first line was successfully decoded, the output file is now opened. 

FILE EQUATION ISSUED BY PRINTER 1: 

FILE 15 ;ACC=OUT;DEV=LPS,,5;ENV=LP60LONG.HPENV 

FILE SUCCESSFULLY OPENED FOR SOLICITED JOB 15 

HOST JOB NUMBER = 159 

EBCDIC TO ASCII TRANSLATION: YES 

SPOOLED: YES. OUTPUT NUMBER = #0147 
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PRINT = 'STD. ' FORMS = 'STD. ' 
CURRENT FORM = 15 



I-S-P-L-A-Y+ 
t 



+ -F-I-L-E--'-I-N-F-0-R-M-A-T-I-0-N---D 
FILE NAME IS 15 

FOPTIONS: NEW, ASCII , FORMAL, U,CCTL,FEQ,NOLABEL 
AOPTIONS: OUTPUT, NOMR, LOCK, SHR,BUF,NOMULTI 
WAIT,NOCOPY 



DEVICE TYPE: 32 
LDEV: 4 DRT: 
RECORD SIZE: 134 
EXTENT SIZE: 
RECPTR: 29 
LOGCOUNT: 29 
EOF AT: 
FILE CODE: 
PHYSICAL STATUS: 
ERROR NUMBER: 85 
BLOCK NUMBER: 29 



DEVICE SUBTYPE: 
UNIT: 
BLOCK SIZE: 136 (BYTES) 
MAX EXTENTS: 
RECLIMIT: 

PHYSCOUNT: 29 
LABEL ADDR: %00400000000 
ID IS ULABELS: 

???????????????? 

RESIDUE: 18 (BYTES) 
NUMREC: 1 



Remaining banner lines follow. The last banner line uses a page eject (%06i) carriage control: 

%201 »A START JOB 159 15 

5i201 *frA START JOB 159 15 

%201 *A START JOB 159 15 

%201 *A START JOB 159 15 

5^061 *A START JOB 159 15 

Text begins: 



0001 


0001 


R0009 


MILES 


0001 


0001 


R0009 


MILES 


0001 


0001 


R0009 


MILES 


0001 


0001 


R0009 


MILES 


0001 


0001 


R0009 


MILES 



fo203 

%201 

%201 

%202 

9^203 

%203 

fo203 

fo203 

%203 

9^061 

9^201 

fo201 

%201 

fo201 

%201 

%201 

%201 

%061 

%201 

%201 

%201 

%201 

fo201 



JES2 JOB LOG 



22.27.38 JOB 159 $HASP373 15 

22.27.39 JOB 159 $HASP395 15 
JES2 JOB STATISTICS 

03 MAY 84 JOB EXECUTION DATE 
89 CARDS READ 
115 SYSOUT PRINT RECORDS 
SYSOUT PUNCH RECORDS 
0.02 MINUTES EXECUTION TIME 

1 //I5 JOB , MILES MSGCLASS=A 
***JOBPARM ,F=I5 

2 // EXEC PGM=IEBGENER 

3 //SYSIN DD DUMMY 

4 //SYSUT1 DD * 

5 //SYSUT2 DD SYSOUT=A 

6 //SYSPRINT DD SYSOUT=A 
// 

IEF236I ALLOC. FOR 15 

IEF237I DMY ALLOCATED TO SYSIN 

IEF237I JES2 ALLOCATED TO SYSUT1 

IEF237I JES2 ALLOCATED TO SYSUT2 



STARTED 
ENDED 



SYSTEM 



- INIT A - CLASS A - 
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%201 

%201 

%201 

%201 

%201 

%201 

fo201 

%201 

%061 

%201 

%201 

%201 

fo201 

%201 

%201 

fo201 

%201 

fo201 

%201 

fp201 

%201 

%201 

%201 

%201 

%201 

%201 

fo201 

%201 

%201 

%201 

%201 

%201 

fo201 

%201 

%201 

fo201 

%201 

%201 

fe201 

%061 
%201 
%201 
%201 
%201 
%201 
fo201 
%201 
%201 
%201 
%201 
%201 
%201 
%201 
%201 



IEF237I JES2 ALLOCATED TO SYSPRINT 
IEF142I 15 - STEP WAS EXECUTED - COND CODE 0000 
IEF285I JES2.JOB00159.SI0101 
IEF285I JES2.JOB00159.SO0102 
IEF285I JES2.JOB00159.SO0103 
IEF373I STEP / / START 84124.2227 

IEF374I STEP / / STOP 84124.2227 CPU 

IEF375I JOB /I5 / START 84124.2227 

IEF376I JOB /I5 / STOP 84124.2227 CPU 

tuvwxy2ABCDEFGHIJKLMN0PQRSTUVWXYZ!@#$%&*( )_+-=" 
uvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ! @#$9^.&* ()_+-=" 
vwxy2ABCDEFGHIJKLMN0PQRSTUVWXYZ!@#$%&*( )_+-=~ ; 
wxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%&* ()_+-=" ; ' 
xyzABCDEFGHI JKLMNOPQRSTUVWXYZ! @#$f*&* ( )_+-=" ; ' 
yzABCDEFGHIJKLMNOPQRSTUVWXYZ?@#$%&*()_+-=~ ;' 
zABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%&*()_+-=~ ; ' 
ABCDEFGHIJKLMNOPQRSTUVWXYZ!@#$%&* ()_+-=" ; ' 
BCDEFGHIJKLMN0PQRSTUVWXYZ!@#$%&«()_4-='' ;' 
CDEFGHIJKLMNOPQRSTUVWXYZ!@#$%&*()_+-=~ ; ' 
DEFGHIJKLMNOPQRSTUVWXYZ!@#$%&* ()_+-=" ; ' 
EFGHI JKLMNOPQRSTUVWXYZ! @#$%&*()_+-=~ ;' 
FGHIJKLMNOPQRSTUVWXYZ!@#$%&*()_+-='^ ;' 
GHIJKLMNOPQRSTUVWXYZ! (§#$%&* ()_+-=" ; ' 
HI JKLMNOPQRSTUVWXYZ? @#$%&«()_+-=~ ;' 
IJKLMNOPQRSTUVWXYZ!@#$%&*()_+-=~ ; ' 
JKLMNOPQRSTUVWXYZ! @#$%&* ( )_+-=" ; ' 
KLMNOPQRSTUVWXYZ!@#$fo&*()_+-=~ ;' 
LMNOPQRSTUVWXYZ! @#$%8c* ( )_+-=~ ; ' 
MNOPQRSTUVWXYZ! @#$%&* ( )_+-=" ; ' 
NOPQRSTUVWXYZ!@#$%&*()_+-=~ ;' 
0PQRSTUVWXYZ!@#$%8c*()_+-=~ ;' 
PQRSTUVWXYZ! (§#$%&* ( )_+-=~ ; ' 
QRSTUVWXYZ!@#$%&* ()_+-=" ;' 
RSTUVWXYZ!@#$%&*()_+-=~ ;' 
STUVWXYZ!@#$%8c* ()_+-=" ;' 
TUVWXYZ!@#$%&« ()_+-=" ;' 
UVWXYZ!@#$%&*()_+-=~ ; 
VWXYZ!@#$%&* ()_+-=" ;' 
WXYZ!@#$%&«( )_+-=" ;' 
XYZ!@#$%&*()_+-=~ ;' 
YZ! <©#$%&* ()_+-=- ;' 
Z!@#$%&*( )_+-=" ;' 

!@#$%&*()_+-='" ;' 

#$%&*()_+-=- ;' 
$%&*()_+-=- ;' 
%&*()_+-='" ;' 
&*()_+-=" ;' 
&*()_+-=" ;' 

*()_+-=- ;' 
()_+-=- ;' 
)_+-=" ;' 



SYSIN 

SYSOUT 

SYSOUT 

OMIN 00.43SEC SRB 

OMIN 00.43SEC SRB 



%2|i = space nn lines after printing. 
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%201 -=" ;' 

%201 =~ ;' 

%201 ~ ;' 

%201 ;' 

5^201 ;' 

%061 ' 

%203 DATA SET UTILITY - GENERATE 

fo201 IEB352I WARNING : OUTPUT RECFM/LRECL/BLKSIZE COPIED FROM INPUT 

%201 

%061 PROCESSING ENDED AT EOD 

%201 *A END JOB 159 15 0001 0001 R0009 MILES 

%2Q\ *A END JOB 159 15 0001 0001 R0009 MILES 

fo201 *A END JOB 159 15 0001 0001 R0009 MILES 

%201 *A END JOB 159 15 0001 0001 R0009 MILES 

%201 *A END JOB 159 15 0001 0001 R0009 MILES 

9^061 *A END JOB 159 15 0001 0001 R0009 MILES 

%000 

OUTPUT FILE FOR JOB 15 SUCCESSFULLY CLOSED 
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COMMAND ERRORS 

MRJE/3000 command errors fall into four general categories. 

• Syntax errors — These include invalid commands as well as commands in improper format. 

• Inaccessible files -- A job is refused if any file named in the SUBMIT command cannot be opened. A 
command is refused if it contains the name of a nonexistent Job Log or Configuration File. 

• Invalid user ID -- A command is refused if a MRJE/3000 User attempts to cancel or display a job they 
do not own. 

• Full Job Log File -- If a MRJE/3000 User attempts to submit a job and the Job Log File is full, the 
SUBMIT command is refused. The MRJE/3000 Manager can make space in the file by purging old 
jobs or by purging all jobs. 

In each of the above categories, MRJE/3000 sends an appropriate message to the user's output device. 

OPERATING FAILURES 

A failure is identified as a Local Failure, or a Remote Failure. A Local Failure is an HP 3 000 hardware or 
software failure. A Remote Failure is a host system or communication line failure. 

Local Failures 

After an HP 3 000 failure, jobs that were submitted to the MPE spooler and jobs that the spooler was 
actively writing to the host card reader are recovered if the system is restarted with a WARMSTART; 
however, any purged extents are lost. Jobs that were being submitted to a non-spooled host card reader 
are lost and must be resubmitted. 

Line printer and punch output being received by the HP 3 000 when a failure occurs is recovered during a 
WARMSTART. Output received by a non -shareable device before the failure is saved whether the device 
was spooled or not spooled. Output in the process of being written to a disc file may be lost. 

After a failure and subsequent restart, the DISPLAY command should be used to determine the status of 
suspect files and jobs. For example: 

• A User submits a job but does not receive a job number or error message. To see whether the job has 
been submitted, the User should enter: 

DISPLAY Jjobname 

• A User cancels a job but does not receive a "JOB CANCELED" message or an error message. To check 
if the job was canceled, the User should enter: 

DISPLAY J,job# 

It may be desirable to check host system output queues. 
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• If you are the MRJE/3000 Manager using the ALTER command to change the Configuration File and 
do not receive a response after entering a new value, you should verify that the file has been updated 
by entering: 

DISPLAY C,item# 

In most cases, an interrupted command must be reentered. This is also true for a host console command if 
the host has not responded. 

If the HP3000 fails while the line to a host is open, the line will automatically be closed. After system 
restart, you must issue MRJECONTROL START command again to reopen the line. 

Remote Failures 

Following a host system or communication line failure, MRJE/300G automatically terminates the 
connection in an orderly manner. It sends a termination message to the HP 3 000 system console, enters 
the termination time in the Configuration File, and shuts down any spooled host card readers it is 
controlling." Spooled files are deferred. 

After the host system has been restarted or the line problems solved, the Console Operator must issue the 
MRJECONTROL START command to restart the subsystem. At the same time the Console Operator 
should assign the deferred spool files a higher priority. 

After a failure, any jobs shown by the DISPLAY command to have been transmitted may not be 
necessarily completely transmitted. For this reason, it may be necessary to do a host console display 
command after the line is reestablished to determine which jobs are on the host system. 

MRJE/3000 MESSAGES 



These messages relate to MRJE/3000 activity: 

• User messages: These are printed on a user's output device. They are listed alphabetically in Table 6-1. 

• MRJECONTROL distributed console messages: These are sent to the terminal of the user who issued 
the MRJECONTROL command. These messages are in Table 6-2 in Command Interpreter Error 
(CI ERR) number order. 

• Console Operator messages: These are sent to the system console. They are listed alphabetically in 
Table 6-3. 

The messages that report an error or failure also include the cause and instructions for corrective action. 
The messages that report information include an interpretation of the message. 

CS ERRORS 



Occasionally failures causing irrecoverable errors occur on a communication system (CS) link. CS errors 
are reported on the system console by code number. The error numbers are included within relevant error 
messages. 
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The Data Communications Handbook describes CS Irrecoverable Error codes and CS Recoverable Error 
codes. An error is irrecoverable when the system is unable to recover from the error without human 
intervention. The system can recover from a Recoverable Error and no action is required by the user; a 
Recoverable Error code may follow an Irrecoverable Error code, thus informing the user that both types 
of errors have occurred. 

GATHERING INFORMATION FOR PROBLEMS 

This provides you with the information on how to: 

• Determine what kind of information to gather when you encounter a problem. 

• Help you during the initial steps of problem solving. 

• Work with your Hewlett-Packard representative when a problem occurs. 

It is in these categories: 

• Common Information, which you always provide when you encounter a problem. 

• Communications Link Information, which you provide when a problem appears to be 
transmission-related. 

• MRJE/3000 Information, which you provide when a problem appears to be MRJE/3000-related. 

You and your Hewlett-Packard representative decide what information to prepare for eventual problem 
resolution. 

Common Information 

This information is invariably needed to resolve a problem. 

• Characterize the problem. Describe the events leading up to and including the problem. Attempt to 
determine the source of the problem. Describe and understand the symptoms of the problem. 

Your characterization should include: MPE commands; Communication subsystem commands; Job 
streams; Result codes and messages; Data that can reproduce the problem. (Actual data is desirable; 
however, you may require that it be synthetic. ) 

Illustrate as clearly as possible the context of any message. Prepare copies of HP 3 000 system console 
and user terminal information. 

Include a history of the site: when was the product installed; when do problems appear; what other data 
communications products are installed; what other products were in use when the problem took place. 

• Obtain the version, update, and fix information of all software. 

Identify the INP, HP30020A, HP30020B, or HP30010A, and the name of the download file in use. 

This allows Hewlett-Packard to determine if the problem is already known, and the correct software is 
installed at your site. 
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• Record all result messages and numbers that appear at the terminal of the user as well as the HP 3 000 
system console for additional analysis by your Hewlett-Packard representative. 

• Always obtain a copy of the generation of the host system you are using for JES2, VTAM, and NCP. 
Determine if there are any differences from your expectations. Retain this for your Hewlett-Packard 
representative. 



• 



Run LISTL0G2. PUB.SYS, a supported utility, to list the contents of of the highest numbered HP3000 
system log file. Inspect the output to determine if there are apparent errors. Create a copy of this 
HP 3 000 system log file for your Hewlett-Packard representative for additional analysis. 

• Try to determine the general area within the software where you think the problem exists. Based on 
the part -specific sections that follow, prepare the information indicated. 

• Issue the MPE command SHOWCOM Zc^ei^; ERRORS, where Idev identifies the logical device number of 
the INP related to the problem. This provides a listing of the status of the INP. Retain this output for 
your Hewlett-Packard representative for additional analysis. 

• Document your interim, or workaround solution. The cause of a problem can sometimes be found by 
comparing the circumstances in which it occurs with when it does not occur. 

• Create duplicate copies of all active or in-use trace files for additional analysis by your 
Hewlett-Packard representative. When you format these trace files using CSDUMP, these files 
describe the communications link activity. 

• Take a full memory dump whenever the system fails or is deadlocked (hung). 



NOTE 



Retain a copy of the file LOADMAP. PUB.SYS with the unformatted dump 
tape for your Hewlett-Packard representative. 



• Always retain unformatted trace and dump files. Your HP representative may need them for 
additional information. 



Communications Link Information 

When a communications link problem appears, in addition to the Common Information described earlier 
in this section, you and your Hewlett-Packard representative need to prepare the following information: 

• If an INP failure has taken place, give the file INPLOGxx.PUB.SYS to your Hewlett-Packard 
representative for additional analysis . 

If the problem is easily reproducible, and tracing was inactive when the problem took place, turn on 
trace using the MPE command MRJECONTROL TRACE... ON .... When the problem has been 
reproduced, turn off trace and give a duplicate of this trace file to your Hewlett-Packard 
representative for additional analysis. 
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NOTE 



It is important to give a copy of the unformatted INP dump that took 
place while link level tracing was enabled to your Hewlett-Packard 
representative for additional analysis. 

• If an INP or SSLC failure has not taken place, turn on trace using the MPE command 

MRJECONTROL TRACE. . .ON. . . 
to create a trace file. This allows your Hewlett-Packard representative to study the line activity. 

• Working with your Hewlett-Packard representative, use DSM, a Hewlett-Packard utility, to provide 
you with additional diagnostic information. 



MRJE/3000 Information 

When a problem is evident in MRJE/3000, in addition to Common Information described in this section, 
you and your Hewlett-Packard representative need to evaluate this information: 

• File MRJESTR^i. PUB. SYS. Prepare a listing of this file. 

• Copies and listings of the Job Log File and the Configuration File, MRJEJOB^i. PUB. SYS and 
MRJECON/Z.PUB.SYS. 

• A copy of the MPE I/O device configuration generated by SYSDUMP. 

• If a failure took place during processing output, attempt to reproduce it on Printer 1 with DBUG 
tracing. Prepare a listing of this output. 
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Table 6-1. MRJE/3000 User Messages 

"ALL" OR "OLDJOBS" ARE ONLY VALID PURGE PARAMETERS. 

A PURGE keyword parameter other than ALL or OLDJOBS was entered. Reenter PURGE 
command with no parameter (for OLDJOBS) or with ALL or OLDJOBS. This error causes program 
termination in batch mode. 

"BS", "CS", "DS", OR "ES" REQUIRED. 

BS, CS, DS, or ES are the only valid values for output process priority in the Configuration File. 
ES is the recommended output process priority. This error causes program termination in batch 
mode. 

^j'obT'^) CANCELED. 

Specified job has been canceled as requested. 

&r^) ^''^'^ ^E CANCELED. 

Named job cannot be canceled because of an error in writing to or reading from a Job Log File. 
Retry the CANCEL. This error causes program termination in batch mode. 

\$CJ hostl P ( ^^^^^^ COMMAND WILL BE SENT TO HOST. 

When an interactive User/Manager cancels a job which has been transmitted to the host and the 
host is on-line, MRJE/3000 automatically sends the appropriate host cancel command and prints 
the host response. 

COMMA OR NUMBER REQUIRED. 

Comma or number is required. This error causes program termination in batch mode. 

COMMA OR SLASH REQUIRED TO SEPARATE PARAMETERS. 

Comma or slash required to separate parameters in joblist or itemlist. This error causes program 
termination in batch mode. 

COMMA REQUIRED TO SEPARATE PARAMETERS. 

Comma is required to separate positional parameters, DAYS, HOURS, MINUTES. This error 
causes program termination in batch mode. 

{SosHLtMaL} CONFIGURATION FILE SET CANNOT BE ACCESSED. 

Named host Configuration File cannot be accessed because of an open or read error. Determine 
the reason for the I/O failure from the MPE file error number. This error causes program 
termination in batch mode. 

CONTINUATION LINE EXPECTED. 

When an ampersand (&) is entered at the end of a line in a command, MRJE/3000 expects the 
following line to be a continuation of the command. Reenter the entire command with the 
continuation line as required. This error causes program termination in batch mode. 

CONTROL-Y IS THE ONLY VALID INPUT DURING HOST COMMAND PROCESSING. 

A User may only enter [CONTROD Y during host console command processing. A [CONTROLl Y halts 
output. Any other input causes this error message and returns the # prompt. If all output has not 
been received, reenter the host console command. This error causes program termination in batch 
mode. 
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filename RECORD m CTRANSLATE FAILED. 

An error occurred while translating a SUBMIT input file from ASCII to EBCDIC (or EBCDIK, 
depending on the translation type). This is an internal software failure. Contact your 
Hewlett-Packard representative for assistance. This error causes program termination in batch 
mode. 

DAYS, HOURS, MINS CAN'T BE ZERO. 

The maximum time a job remains in the Job Log File after transmission cannot be zero. This 
error causes program termination in batch mode. 

DEFAULT HOST ASSUMED. 

If no host name is given in a HOST or NEW command, MRJE/3000 assumes the default host is 
desired. 

DIGIT OR SPECIAL CHARACTER REQUIRED. 

Host system character must be a digit or a special character. Reenter command. This error causes 
program termination in batch mode. 

n DIGITS ARE THE MAX ALLOWED FOR THIS NUMBER. 

A number with too many digits has been entered. Reenter command with no more than n digits. 
This error causes program termination in batch mode. 

$DJ host# DISPLAY COMMAND WILL BE SENT TO HOST. 

When an interactive User/Manager displays a job that has been transmitted to the host and the 
host is on- line, MRJE/3000 automatically sends the appropriate host display command and prints 
the host response. 

jobname: DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY OF JOBS WITH THIS 
NAME WHICH YOU OWN (IF ANY) FOLLOWS: 

A CANCEL by job name is refused if duplicate names exist in the Job Log File. Reenter the 

CANCEL command, specifying jofc># rather than jobname. 

EMBEDDED BLANKS NOT ALLOWED IN QUALIFIED NAME. 

A qualified actual file designator may not contain embedded blanks. Reenter. This error causes 
program termination in batch mode. 

END OF FILE ON $STDINX. FURTHER INPUT IMPOSSIBLE. FATAL ERROR! 

End-of-file on standard input device. Further input is impossible. MRJE/3000 terminates. A 
user may have entered an :EOD after issuing a SUBMIT $STDINX command. Run the job again 
and do not use : EOD or : EOF in SUBMIT. Use MRJEOD to terminate input. This error causes 
program termination in batch mode. 



6-19 



Table 6-1. MRJE/3000 User Messages (continued) 



ENTER INPUT ENDING WITH "MRJEOD" . 

This message followed by a prompt (>) requests input from $STDIN/$STDINX during SUBMIT. If 
$STDIN or $STDINX are FD files, any comment on the ##FD card appears ahead of this message. 
For example, assume infile DATA 1 contains the record 

##FD $STDIN This input is for file DATA1 . 

When this ##FD card is read by MRJE/3000, the following appears on the terminal: 

This input is for file DATA1 . 
ENTER INPUT ENDING WITH "MRJEOD" 
> 

EXTRANEOUS INFORMATION AFTER VALID ITEM. 

Some extra information has been included that MRJE/3000 does not recognize. Reenter with 
only the required information. This error causes program termination in batch mode. 

##FD CARDS NOT PERMITTED IN LEVEL 2 FILE. 

File Definition cards may be contained only in an infile (level 0) or a first -level FD file. Remove 
the ##FD card from the named level 2 file, reconstruct input files as required, and resubmit job(s). 
This error causes program termination in batch mode. 

FILE ERROR nn , filename CAN'T BE CLOSED. 

Named SUBMIT file (input or output) cannot be closed. SUBMIT processing continues. 
Determine the reason for the failure from MPE file system error number {nn). 

FILE ERROR nn , filename CAN'T BE CLOSED. FATAL ERROR? 

Named file (Configuration, Directory, Job Log, or host console device) cannot be closed. 
MRJE/3000 terminated. Determine the reason for the failure from MPE file system error 
number (nn). This error causes program termination in batch mode. 

FILE ERROR nn , filename CAN'T BE OPENED. 

Named file cannot be opened. Determine the reason for the failure from MPE file system error 
number {nn). This error causes program termination in batch mode. 

FILE ERROR nn , filename CAN'T BE OPENED. FATAL ERROR! 

Named list file (if other than $STDLIST) cannot be opened. MRJE/3000 terminated. Determine 
the reason for the failure from MPE file system error number {nn). This error causes program 
termination in batch mode. 

FILE ERROR nn , MRJEJOB/? RECORD m CAN'T BE POSTED. 

Record m of Job Log MRJEJOB/z cannot be physically transferred from the I/O buffer to the disc 
file. Determine the reason for the I/O failure from MPE file system error number {nn). This 
error causes program termination in batch mode. 

{filename RECORD m ^ 
HOST CONSOLE OUTPUT \ CAN'T BE READ. 
STANDARD INPUT FILE J 
Determine the reason for I/O failure from MPE file system error number (nn). This error causes 
program termination in batch mode. 
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FILE ERROR nn , filename RECORD m CAN'T BE WRITTEN. 

Record m of the named file cannot be written. Determine the reason for the I/O failure from the 
MPE file system error number (««). This error causes program termination in batch mode. 

FILE ERROR nn , filename RECORD m CAN'T BE WRITTEN. FATAL ERROR! 

Output record m cannot be written to the named list file. MRJE/3000 terminated. Determine 
the reason for the I/O failure from the MPE file system error number (nn). This error causes 
program termination in batch mode. 

FILE ERROR nn, (MONITOrCARD^^^ "^ } ^^^ "^ ^^ WRITTEN TO HOST READER. 

Record m of the SUBMIT input file, or the monitor card can not be written to the host reader. A 
Monitor Card associates a host job with a pseudo reader. Determine the reason for the I/O failure 
from the MPE file system error number (nn). This error causes program termination in batch 
mode. 

FILE ERROR nn , CAN'T CLOSE $STDINX. HOST CONSOLE COMMANDS CAN'T BE SENT. 

SSTDINX (standard input device) must be closed, then reopened for NOWAIT I/O, in order to send 
host console commands. Determine the reason for the failure from the MPE file system error 
number (nn). This error causes program termination in batch mode. 

FILE ERROR nn, HOST BUSY. CONSOLE COMMAND NOT SENT. 

Host pseudo console device has received more messages from the host than it can handle. 
Determine the reason for the failure from the MPE file sytem error (nn). 

FILE ERROR nn, HOST CONSOLE CAN'T BE OPENED. 

Host pseudo console device specified in the configuration file cannot be opened. Most commonly 
another someone else is using the console. Determine the reason for the failure from MPE file 
system error number (nn). This error causes program termination in batch mode. 

FILE ERROR nn, HOST CONSOLE COMMAND CAN'T BE WRITTEN. 

Host console command cannot be written to the host pseudo console device specified in the 
configuration file. Determine the reason for the I/O failure from the MPE file system error 
number (nn). This error causes program termination in batch mode. 

hostname FILES CREATED. 

The Configuration File set for the named host has been created as requested in the NEW 
command. 

FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 

When creating a new Configuration File, certain items that do not have default values must be 
initialized. 

FORMID MUST CONSIST OF 1 TO 8 CHARACTERS 

A FORMID, the key into MRJETABL, may consist of 1 to 8 alphanumeric, IBM national, or period 
(.) characters delimited by single quotes ('). Reenter. This error causes program termination in 
batch mode. 

FORMID MUST BE TERMINATED WITH A SINGLE QUOTE ('). 

A FORMID, the key into MRJETABLE, must be delimited with single quote (') characters. 
Reenter. This error causes program termination in batch mode. 
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FORMS SPECIFIED TWICE. 

The FORMS file is specified twice in a SUBMIT command. Reenter the SUBMIT command, 
specifying FORMS only once. This error causes program termination in batch mode. 

GET PRIVILEGED MODE FAILURE. FATAL ERROR! 

An error occurred in the GETPRIVMODE intrinsic. This is an internal software failure. Contact 
your Hewlett-Packard representative for assistance. This error causes program termination in 
batch mode. 

GET USER MODE FAILURE. FATAL ERROR! 

An error occurred in the GETUSERMODE intrinsic. This is an internal software failure. 
Contact your Hewlett-Packard representative for assistance. This error causes program 
termination in batch mode. 

HOSTNAME MUST START WITH SAME CHAR AS HOSTID 

The first character of a host name must be the same as the first character of the host ID given in 
the NEW command. Reenter. This error causes program termination in batch mode. 

jobname IN DIRECTORY (ENTRY n) BUT NOT IN JOB LOG. FATAL ERROR! 

A jobname has been found in Directory File entry n, but cannot be found in the Job Log. 
MRJE/3000 terminated. This is an internal software failure. Do not permit further jobs to be 
submitted to this Job Log. When all jobs in it have completed, use FCOPY to list the Directory 
and Job Log Files: 

:FILE L;DEV=LP 

: FCOPY 

> FROM=MR JE JOB/? ; T0=* L ; OCTAL ; CH AR 

>FR0M=MRJEDIR/7;T0=*L;0CTAL;CHAR 

>EXIT 

h is the host ID. Show the listing to your Hewlett-Packard representative. Use the PURGE ALL 
command to reinitialize the Directory and Job Log Files. This error causes program termination 
in batch mode. 

INPUT FILE NAME(S) REQUIRED. 

SUBMIT requires at least one input file name. Reenter the command. This error causes program 
termination in batch mode. 

INTEGER OF TO 255 REQUIRED 

The translation type for Configuration Item 38 is out of bounds. Reenter. 

INPUT MUST BE NUMERIC 

Numeric input required. Reenter. This error causes program termination in batch mode. 

INTERACTIVE TERMINAL REQUIRED FOR HOST CONSOLE COMMANDS. 

User/Manager must run MRJE/3000 interactively in order to send host console commands from a 
terminal. Console commands may also be sent as part of an IBM JCL deck, but they must be in 
batch format. 
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INVALID ACTUAL FILE DESIGNATOR 

A fully qualified actual file designator is: 

filename /lockword. groupnatne. accountname 

where ...names and lockword each have a maximum of eight alphanumeric characters, and the 
first character is alphabetic. No embedded blanks are permitted. Reenter. This error causes 
program termination in batch mode. 

INVALID COMMAND. 

MRJE/3000 does not recognize the input as a command. Enter a valid MRJE/3000 or host Job 
Entry Subsystem command. This error causes program termination in batch mode. 

INVALID DEVICE CLASS SPECIFICATION. 

A valid device class specification name has a maximum of eight alphanumeric characters, starting 
with an alphabetic character. No embedded blanks are permitted. Quotation marks are required, 
as follows: "name". Reenter. This error causes program termination in batch mode. 

INVALID FILE EQUATION SPECIFICATION 

Name must be less than or equal to seven characters. Consult your system administrator for more 
details. This error causes program termination in batch mode. 

INVALID HOST SYSTEM. 

HASP, JES2, JES3, ASP, and RSCS are the only vahd host Job Entry Subsystems. Reenter. This 
error causes program termination in batch mode. 

INVALID HOSTID. MUST BE ALPHANUMERIC, <=8 CHARS. 

Valid host ID has a maximum of eight alphanumeric characters. Reenter. This error causes 
program termination in batch mode. 

INVALID JOBNAME--TOO LONG. 

Eight characters is the maximum length for host job name. Reenter. This error causes program 
termination in batch mode. 

INVALID KEYWORD. 

Valid keywords are READER, PRINT, PUNCH, FORMS. Reenter SUBMIT command. This error 
causes program termination in batch mode. 

INVALID OCTAL NUMBER. 

Octal number cannot contain blanks or the digits 8 and 9. Reenter. This error causes program 
termination in batch mode. 

Invalid output specification. Valid designations are: 
FORMID record in MRJETABL, using single quotation marks ('). 
Device class name, using double quotation marks ("). 
Logical device number. 
Actual file designator. 
Zero (0). 

An output specification was improperly delimited, or contained an illegal value. This error causes 

program termination in batch mode. 
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INVALID PARAMETER FOR DISPLAY COMMAND. 

Valid DISPLAY parameters are CONFIGURATION, DIRECTORY, HOST, JOBLOG, OLDJOBS, 
STATUS. Reenter DISPLAY command with correct parameter. This error causes program 
termination in batch mode. 

INVALID SPECIAL CHARACTER. 

Reenter using one of the following special characters only: 

This error causes program termination in batch mode. 

INVALID SUBMIT PARAMETER. 

Valid SUBMIT parameters are in file, (N) , (N,T) , (T,N) , (T) and the keywords READER, 
PRINT, PUNCH, and FORMS. Reenter SUBMIT command. This error causes program termination 
in batch mode. 

deoice IS AN INVALID PSEUDO LINE MONITOR DEVICE. FATAL ERROR! 

MRJE/3000, in determining whether the host is on-line or off-line, has found that the pseudo 
line monitor logical device number in the Configuration File is invalid. Ensure that the logical 
device number in the Configuration File correctly indicates the pseudo line monitor device 
configured on the 3000. This error causes program termination in batch mode. 

jobname IS NOT YOUR JOB. 

Requested job is not canceled or displayed because the user's logon ID does not match that in the 
Job Log File entry. Reenter CANCEL or DISPLAY with correct job name or job number. This 
error causes program termination in batch mode. 

hostname IS OFF-LINE. 

The named host is off-line. 

hostname IS OFF-LINE. HOST CONSOLE COMMAND CAN'T BE SENT. 

Host console command cannot be sent because named host is off-line. Reenter command when 
host is on-line. 

hostname IS OFF-LINE. JOB CAN'T BE CANCELED AT HOST. 

Job to be canceled has been transmitted to host, but the host is now off-line, so a CANCEL 
command cannot be sent to host. However, the cancel flag in the job log entry is set so that any 
output from the job is flushed. This error causes program termination in batch mode. 

hostname IS ON-LINE. 

The named host is on-line. 

hostname IS THE CURRENT HOST MACHINE 

The named host is the host to which all succeeding commands are directed. 

n IS THE MAX LEVEL OF NAMES IN THIS ACTUAL FILE DESIGNATOR, 

Lockword, groupname, and accountname are the only permissible file name qualifications. This 
error causes program termination in batch mode. 

n IS THE MAXIMUM NUMBER OF CHARACTERS FOR THIS PARAMETER. 

Certain inputs, such as phone number in the configuration file, cannot exceed a specified length. 
Reenter. This error causes program termination in batch mode. 
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commnd IS THE ONLY VALID CONSOLE COMMAND. 

A User can enter only the host console commands designated by the Manager in the Configuration 
File in Item 6. Reenter. This error causes program termination in batch mode. 

m TO rt IS THE VALID RANGE FOR THIS PARAMETER. 

The number specified is not within valid range. Reenter. This error causes program termination 
in batch mode. 

ITEM 4 ONLY DISPLAYED FOR MANAGER. 

Item 4 in the Configuration File, the host SIGNON card image, is displayed only for the 
MRJE/3000 Manager. 

ITEM NOT USED WITH THIS HOST SYSTEM. 

Items 11 and 17 in a Configuration File are not used with a JES3 or ASP host. Item 14 is not 
used with JES2 or HASP. Items 10, 15-17, 20, 22-28, 30-35 and 42 are not used by RSCS. This 
error causes program termination in batch mode. 

ITEM NUMBER REQUIRED. 

When altering a Configuration File, item number is required. Reenter with an item number. This 
error causes program termination in batch mode. 

JOB ALREADY CANCELED. 

A CANCEL request has been entered for a job which has already been canceled. The Job Log File 
entry is displayed. 

JOB nn CAN'T BE CANCELED DUE TO A PREVIOUS SYSTEM FAILURE. 

This message occurs if the system is restarted between the time a job is submitted and the time a 
CANCEL request is issued. A system restart invalidates the spool file numbers that would 
normally be used in a cancelation procedure. Thus, the CANCEL request fails. After receiving all 
output for all jobs, issue a PURGE OLDJOBS from MRJE/3000. 

JOB CAN'T BE CANCELED AT HOST FOR NON-INTERACTIVE USER. 

Job to be canceled has been transmitted to the host, but since the User/Manager is not running 
MRJE/3000 interactively the CANCEL command cannot be sent to the host. However, the cancel 
flag in the Job Log File entry is set so that any output from the job is discarded. This error causes 
program termination in batch mode. 

JOB NOT CANCELED. 

When any user requests that a job be canceled, the job log entry is displayed. In an interactive 
session MRJE/3000 then asks for verification of the CANCEL. If the response is anything other 
than YES, the job is not canceled. 

n JOBS ARE IN THE JOBLOG. VERIFY PURGE WITH "YES". 

When the Manager enters the PURGE ALL command MRJE/3000 checks to see whether there 
are any jobs in the job log. These jobs may not have completed. If there are remaining jobs, then 
a Manager running interactively is asked to verify the PURGE request by typing YES. 

JOB rtn NO JOBLOG ENTRY. 

No Job Log File entry exists for the job specified in a CANCEL or DISPLAY command. Display 
by job name to determine the correct job number. 

LOGICAL DEVICE NUMBER OR DEVICE CLASS REQUIRED. 

A logical device number or device class is the only valid input. Back -references not permitted. 
Reenter. This error causes program termination in batch mode. 
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Table 6-1. MRJE/3000 User Messages (continued) 

MANAGER CAPABILITY IN EFFECT. 

This user has OP, System Supervisor, capability. 

MANAGER CAPABILITY REQUIRED FOR THIS COMMAND 

This command is not available to a user without OP, System Supervisor, capability. This error 
causes program termination in batch mode. 

MAXIMUM OF 5 INPUT FILES ALLOWED. 

A SUBMIT command accepts a maximum of five explicit input files. Reenter the SUBMIT 
command. This error causes program termination in batch mode. 

MISSING RIGHT PARENTHESIS. 

Closing right parenthesis has been omitted from the (NOTRANSLATE) or (TRANSPARENT) 
parameter. Reenter the SUBMIT command. This error causes program termination in batch 
mode. 

MRJECON/7 FILE ALREADY EXISTS. REPLY "YES" TO RECREATE. 

The host named in NEW command already has a set of Configuration Files. In an interactive 
session the Manager is asked to verify that the existing files are to be deleted and new ones 
created. Reply YES to delete the existing set of Configuration Files. Any other response retains 
the existing files. 

MRJECON/? NOT ALTERED. 

No change has been made to the named configuration file because of an I/O error, invalid input, 
or no new value being entered when requested. If a change is required, reenter the ALTER 
command. 

MRJECON/7 SUCCESSFULLY ALTERED. 

The named Configuration File has been successfully altered as requested. 

MRJEJOB/7 COMPLETELY PURGED OF ALL JOB ENTRIES. 

The named Job Log has been completely purged as requested. 

MRJEJOB/7 DIRECTORY FULL. NO FURTHER JOBS CAN BE SUBMITTED. 

The Directory File of the named Job Log indicates that the Job Log is full. PURGE the named 
Job Log File of old, inactive jobs. This error causes program termination in batch mode. 

MRJEJOB/? DIRECTORY/JOBLOG UPDATE CAN'T BE COMPLETED. FATAL ERROR! 

Some or all entries have been deleted from the Job Log File during PURGE, but the Job Log or 
Directory File cannot be updated because of an I/O error. MRJE/3000 terminated. Rebuild the 
set of Configuration Files for this host using the NEW command. This error causes program 
termination in batch mode. 

MRJEJOB/7 END OF FILE. 

An end -of -file has been reached in a search of the named job log. 

MRJEJOB/7 n JOBLOG ENTRIES CLEARED, m FREE ENTRIES NOW EXIST. 
A PURGE command cleared n entries from the named job log file by: 

• Deleting canceled jobs 

• Deleting timed out jobs 

• Clearing Directory File entries that were reserved for jobs that failed during SUBMIT. 
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Table 6-1. MRJE/3000 User Messages (continued) 



MRJEJOB/7 NOT PURGED. 

The named Job Log has not been purged because the Manager negated the request, or an I/O error 
occurred. If PURGE is required, determine the reason for failure from the MPE file error number 
given in the I/O error message and reenter the PURGE command. 

MRJEJOB/7 n OLD JOBS IN THIS FILE. 

The named Job Log contains n oW jobs. An old job has either timed -out, or has been canceled. It 
is subject to purging. 

MRJEJOB/7 n OLD JOBS PURGED THUS FAR. 

An error has occurred during PURGE processing which makes a Directory or Job Log File update 
impossible. However, n old jobs have already been deleted from the Job Log File. Rebuild the 
Configuration Files for this host using the NEW command. 

current command character MUST BE FIRST CHAR IN USER HOST CMD. 

The specified command character must be the first character entered in the User host command. 
For example, if the host system command character is a dollar sign ($), the User host command 
cannot be %DA. This error causes program termination in batch mode. 

NO BLANKS ALLOWED IN FORMAL FILE DESIGNATOR 

Embedded blanks are not permitted within a back referenced file designator. Reenter. This error 
causes program termination in batch mode. 

NO CLOSING QUOTE ON DEVICE CLASS NAME. 

A valid device class must be enclosed in quotes. Reenter. This error causes program termination 
in batch mode. 

NO FILE DESIGNATOR ON ##FD CARD. 

An ##FD card with no file designator has been found in a SUBMIT input file. Correct the ##FD 
card and resubmit. This error causes program termination in batch mode. 

NO JOB CARD FOUND. 

MRJE/3000 has read and spooled or transmitted all SUBMIT input Unfiles and FD files) without 
finding a host JOB card with the form: 

//jobname JOB optional information 

Add a valid host job card and resubmit. 

NO NEW FILES CREATED. 

If an error occurs or the MRJE/3000 Manager enters (CONTROL) Y during NEW command processing, 
no new set of Configuration Files is created. If new files are required, determine the reason for 
failure from the MPE file error number given in the I/O error message and reenter the NEW 
command. This error causes program termination in batch mode. 

NO PARAMETERS ALLOWED. 

No parameters are allowed in this command. Reenter the command. 

NO SPOOL FILE FOUND. 

Message occurs when a job is canceled and no spool file exists that contains information to be 
transmitted for the canceled job. 
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Table 6-1. MRJE/3000 User Messages (continued) 



jobname NOT FOUND. 

The job named in a CANCEL or DISPLAY command is not in the Job Log. Ensure that job name 
is correct and reenter the command. The Manager may DISPLAY the entire Job Log to check job 
names. 

{job''''"^} not submitted. 

The job identified as jobname, or JOB if MRJE/3000 did not find a host card, was not submitted to 
the host. Make certain the job has a recognizable job card. 

NOTRANSLATE CAN'T BE SPECIFIED FOR $STDIN/$STDINX. 

Input from the standard input file is always translated from ASCII to EBCDIC or EBCDIK, 
depending on translation type. Reenter SUBMIT command, deleting the (NOTRANSLATE) 
parameter from $STDIN/$STDINX. This error causes program termination in batch mode. 

"NOTRANSLATE" REQUIRED. 

(NOTRANSLATE) or (TRANSPARENT) are the only parenthesized parameters allowed in the 
SUBMIT command. Reenter command. This error causes program termination in batch mode. 

NUMERIC PARAMETER EXPECTED. 

Numeric input is expected after a comma. Reenter. This error causes program termination in 
batch mode. 

ONLY 3 PARAMETERS ARE ALLOWED. 

Only three values, days, hours, and minutes, can be given to specify the maximum time a job 
remains in the Job Log after transmittal. Reenter. This error causes program termination in batch 
mode. 

out file : OUTPUT FILE DOES NOT EXIST. 

The outfile named in a PRINT, PUNCH, or FORMS parameter of a SUBMIT command does not 
exist. Build the named output file and resubmit. This error causes program termination in batch 
mode. 

PARAMETERS REQUIRED. 

The given command requires parameters. Reenter the command. This error causes program 
termination in batch mode. 

PRINT SPECIFIED TWICE. 

A PRINT parameter is specified twice in a SUBMIT command. Reenter the command, specifying 
PRINT once. This error causes program termination in batch mode. 

PUNCH SPECIFIED TWICE 

A PUNCH parameter is specified twice in a SUBMIT command. Reenter the command, specifying 
PUNCH once. This error causes program termination in batch mode. 

reader READER CANNOT BE CLOSED. 

The named pseudo reader cannot be closed. Determine the reason for the failure from subsequent 
MPE file system error message number. This error causes program termination in batch mode. 

READER SPECIFIED TWICE. 

The READER parameter is specified twice in a SUBMIT command. Reenter the command, 
specifying READER once. This error causes program termination in batch mode. 
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Table 6-1. MRJE/3000 User Messages (continued) 

SPOOL FILE DELETED. 

You see this message when a job is canceled before it is transmitted to the host, and the spool file 
containing it is deleted. 

SPOOL FILE NOT IN READY STATE. UNABLE TO DELETE. 

You see this message when a job is canceled while it is being transmitted to the host. The spool 
file is busy and cannot be deleted. The cancel flag is still set. 

STANDARD INPUT FILE CAN'T BE OPENED. FATAL ERROR! 

$STDINX cannot be opened. MRJE/3000 terminates. This error causes program termination in 
batch mode. 

STANDARD INPUT FILE CAN'T BE OPENED FOR NOWAIT I/O. 

The $STDINX file must be opened for NOWAIT I/O in order to send host console commands. 
This error causes program termination in batch mode. 

$STDIN, $STDINX, $OLDPASS ARE ONLY SYSTEM INPUT FILES ALLOWED. 

Only those system files named in the message can be used for infiles or FD files. Other system 
files are prohibited. Reenter SUBMIT with valid input files. This error causes program 
termination in batch mode. 

THIS ITEM NOT DYNAMICALLY CONFIGURABLE. 

Items 1, 18, 40, and 41 cannot be altered after the Configuration File has been created. In order to 
change these items, use the NEW command to reconstruct the Configuration File. This error 
causes program termination in batch mode. 

USER CAPABILITY IN EFFECT. 

You do not have OP (System Supervisor) capability, and cannot carry out MRJE/3000 Manager 
functions. 

VALID RESPONSE MUST BE GIVEN. 

When creating a new set of Configuration Files, items that do not have default values must be 
initialized. MRJE/3000 continues to ask for a valid response until one is given or until the 
Manager enters [CONTROLl Y. in which case no new files are created. This error causes program 
termination in batch mode. 

VERIFY CANCEL WITH "YES". 

When User/Manager requests that a job be canceled, the Job Log entry is displayed. In an 
interactive session MRJE/3000 then asks for verification of the CANCEL. Reply YES to verify 
cancellation. 

WARNING: HOST COMMAND CARD FOUND IN INPUT-NOT TRANSMITTED. 

MRJE/3000 did not transmit the record to the host. SUBMIT processing continues. 

WARNING; MRJEOD CARD FOUND IN INPUT-NOT TRANSMITTED. 

An MRJEOD card is only required when an input file Unfile or FD file) is $STDIN or $STDINX. If 
an MRJEOD card is found in any other input file, it is not transmitted to the host. SUBMIT 
processing continues. 
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Table 6-1. MRJE/3000 User Messages (continued) 

WARNING: SIGNOFF CARD FOUND IN INPUT-NOT TRANSMITTED. 
A signof f card has the form: 

/*SIGNOFF 

MRJE/3000 did not transmit this record to the host. SUBMIT processing continues. 



"YES" OR "NO" REQUIRED. 

YES or NO is the only valid response. Reenter. This error causes program termination in batch 
mode. 

YOU MUST LOG ON MANAGER. SYS TO CREATE/PURGE CONFIG FILES. 

The MRJE/3000 Manager must be logged on to M AN AGER. SYS,PUB to create the Configuration 
File, the Job Log File, and the Directory File with a NEW command, or to purge all entries from the 
Job Log File with a PURGE ALL command. These files are in PUB. SYS. This error causes program 
termination in batch mode. 
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MRJECONTROL CONSOLE MESSAGES 

The messages in Table 6-2 can be received by MRJE/3000 users while using MRJECONTROL commands. 

Table 6-2. MRJECONTROL Console Messages 

Command Message, Meaning, and Recovery 

Interpreter Error 
(CI ERR) Number 

4200 EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: START, TRACE, 
RETRIES, SIGNOFF, KILL, CHECK, OR VERIFY. 

Entering MRJECONTROL alone is incorrect. Enter MRJECONTROL with one of the 
control command parameters listed in this message. 

4201 EXCEEDED MAXIMUM NUMBER OF PARAMETERS. 

Look up syntax of MRJE/3000 command and reenter using no more than the 
maximum number of parameters allowed. 

4202 START ALREADY REQUESTED. 

The MRJECONTROL START command has already been issued, but the line is not 
fully open. Before the command can again be successfully issued, the 
MRJECONTROL SIGNOFF or MRJECONTROL KILL command must be executed. 

4203 EXPECTED TWO PARAMETERS, HOSTID AND RETRYNUM. 
Reenter command using both parameters. 

4204 . UNABLE TO OPEN CONFIGURATION FILE FOR THIS HOST. 

These are some reasons for this message: 

• The wrong host ID may have been used in the command. 

• Someone may be altering or rebuilding the Configuration File. 

• There may be no Configuration File for this host. 



4205 UNABLE TO ACCESS CONFIGURATION FILE FOR THIS HOST. 
An FWRITE or FREAD intrinsic for this file failed. 

4206 INSUFFICIENT CAPABLITIES FOR MRJECONTROL COMMANDS. 

A user must be authorized to use MRJECONTROL commands through the MPE 
ALLOW command. 

4207 UNABLE TO CREATE MRJEMON. 

Issue LISTF MRJEMON . PUB. SYS to see if the file exists. If it does not exist, check the 
MPE configuration. 

4208 UNABLE TO ACTIVATE MRJEMON. 

Issue LISTF MRJEMON . PUB. SYS to see if the file exists. If it does, check MPE 
configuration. 
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Table 6-2. MRJECONTROL Console Messages (continued) 

4209 MRJE ALREADY ACTIVE. 

Line already open. Command is ignored. 

4210 NUMBER OF RETRIES MUST BE IN RANGE 1 - 255. 
Reenter command with RETRIES within range. 

4211 SIGNOFF ALREADY REQUESTED. 

Command in process. If the line won't close, it may be necessary to issue an 
MRJECONTROL KILL. 

4212 KILL ALREADY REQUESTED. 

An MRJECONTROL KILL command already has been requested. If the line won't 
close, it may be necessary to physically disconnect it. 

4213 INVALID DEVICE FOR MRJEO. 

The logical device numbers for items 2 and 3 of the Configuration File differ from 
those in the MPE I/O system configuration. Alter the Configuration File. 

4214 EXPECTED AT LEAST ONE PARAMETER, "ON" OR "OFF". 
Issue MRJECONTROL TRACE with an ON or an OFF parameter. 

4215 MRJE NOT ACTIVE. 

Issue an MRJECONTROL START command, and then reissue command. 

4216 NO SYSTEM BUFFER AVAILABLE. COMMAND FAILED. 

Reissue command until it succeeds. If problem persists, contact your 
Hewlett-Packard representative. 

4217 "TRACE" ONLY VALID COMMAND HERE. 
No other parameters are allowed. 

4218 MRJEMON ADOPT FAILURE. 

Contact your Hewlett-Packard representative. 

4219 HOST ID MUST BE ALPHANUMERIC. 

Host ID may not contain a special character. 

4220 SIGNOFF INVALID UNTIL HOST CONNECTION COMPLETED. 
MRJECONTROL SIGNOFF cannot be executed until the communications line is 
open. 
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MRJE/3000 MESSAGES SENT TO SYSTEM CONSOLE 

MRJE/3000 sends messages described in Table 6-3 to the HP3000 system console in the format that 
follows. 

When the system console is used for MRJECONTROL commands, messages described in Table 6-2 can 
appear. When the system console is used as a user terminal, messages described in Table 6- 1 can appear. 



Console Message Format 

The format of MRJE/3000 system console messages always includes the time when the message was sent, 
the MPE process identification number of MRJEMON, a host id letter, and message from Table 6-3. 



time/ pin /l^R J Eh 



WARNING: 

ERROR: 

ERRnnn: 



message 



Console Message Itenns 



or 



time 

pin 

MRJE/7 

MRJE 

message 

WARNING: 

ERROR: 

ERRnnn: 



The time of day the message was sent. 

The MPE process identification number of MRJEMON. 

Indicates MRJE/3000 generated the message and that the message concerns the 
host system whose ID begins with the alphanumeric character h. If h is absent, this 
message applies to the default host system. 

The message text, as in Table 6-3. 

This message reports a potential problem. 

This message reports a failure. 

Indicates a failure where nnn >= 100, and identifies an MRJE/3000 software error. 



File System Error Messages 

All File System error messages consist of two lines: 

• The first line indicates the affected MRJE/3000 process, the type of failure, the File System error 
number, and the name of the file on which the error occurred. 

• The second line is the File System error message and corresponds to the File System error number on 
the first line. 
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Errors can occur on these files: 

MRJECON/7, the MRJE/3OO0 Configuration File. 

MRJEO, the MRJE/3000 pseudo driver lOMRJEO. 

CS DEVICE, the INP (or SSLC on Series III) communications controller. 

MRJEDIR/7, the MRJE/3000 job Directory File. 

MRJEJOB/7, the MRJE/3000 Job Log File. 

MRJE1, the MRJELOGR pseudo driver I0MRJE1. 

MRJEOUT, the output file. 

MRJE'PNLP, the MRJEOUT pseudo driver lOMPNLPO. 

BANNER, a temporary file used to save host output banners. 

MRJETABL, the permanent file MRJETABL . PUB. SYS. 

MRJETBL/?, a temporary file and a copy of MRJETABL. PUB. SYS. 

MRJEFRM/7, a permanent file in PUB. SYS used to retain the name of the form currently being used. 

MRJEMSG/7, a permanent non-IPC disc file, name. group. acct, used for logging host console messages 
sent to the remote workstation. 



NOTE 



A file system error on these files is usually a symptom of an internal 
software problem, except as described in messages that follow. 

If an error message can be duplicated, contact your Hewlett-Packard 
representative. 

All messages sent to the system console are also printed on the $STDLIST 
device for the MRJE/3000 Monitor process. The output of the Stream File 
MRJESTR/z contains a record of all MRJE/3000 console messages. For file 
system errors, a PRINT'FILE'INFO file information display is output to the 
$STDLIST device. 
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Console Messages 

Table 6-3 lists MRJE/3000 messages sent to the system console in alphabetical order. Each message is 
followed by an explanation, and may be followed by a solution. 

Table 6-3. MRJE Messages Sent to System Console 

ACTIVATE FAILURE ON MRJEMON. 

Internal software error. Contact your Hewlett-Packard representative. 

CONFIG FORMID NOT FOUND IN MRJETABL 

FORM ID NOT FOUND = formname 

Fatal error. A formname for either solicited or unsolicited output references a record in 
MRJETABL which was not found. Insure that the record does exist. A formname begins in 
column 1, and is padded with blanks to column 8. Items 20 - 35 of a Configuration File can refer 
to a formname, as follows: 

'formname' 

If a FORMID is accessed frequently, it should be near the beginning of the table to optimize 
performance. 

CONFIGURED BUFFER SIZE INVALID. 

The buffer size in the MRJE/3000 Configuration File Item 43 is invalid. The MRJE/3000 
Manager must alter the item in the Configuration File to be compatible with the host system 
buffer size. 

CONSMRJE, OPEN FAILURE {nn) ON $NULL. 

File system error nn. Contact your Hewlett-Packard representative. 

CONSMRJE, OPEN FAILURE {nn) ON MRJECON/?. 

The specified MRJE/3000 Configuration File could not be opened. If the Configuration File 
exists, determine the cause of the failure from the file system error number [nn] and take 
corrective action. 

CONSMRJE, READ FAILURE (nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

CONSMRJE, WRITE FAILURE (nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

CREATE FAILURE ON MJOBLOGR. 

The job-logging process could not be created. Ensure that MRJELOGR is present in PUB. SYS. 

CREATE FAILURE ON MRJEMON. 

The MRJE/3000 monitor process could not be created. Ensure that MRJEMON is present in 
PUB. SYS. 

CREATE FAILURE ON MRJEOUT. 

An MRJE/3000 output process could not be created. Ensure that MRJEOUT is present in 
PUB. SYS. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 

CS, OP AND SM REQUIRED TO RUN MRJEMON 

The MRJE/ 3 000 Monitor process can only be run by a user whose capabilities include CS, OP, and 
SM. 

DATA RECEIVED FOR INVALID UNIT #/?w. 

The host system has sent data to an unconfigured pseudo device. 

1. Backspace the host device corresponding to unit 
nn. For example. Printer 1 corresponds to Unit 
3. 

2. Halt the host device corresponding to Unit nn. 
Drain the host device corresponding to Unit nn. 
Reroute output from the host device to Printer 1, 
Unit 3, which should always be configured on an 
HP3000. 

3. As soon as convenient, reconfigure the 
MRJE/ 3 000 pseudo I/O devices so that the host 
and the HP3000 system have the same 
configuration. 

MRJE/ 3000 pseudo devices must be configured with these unit numbers: 

Unit: Corresponding Device: 

- 1 Line monitors. 

2 Pseudo console. 

3-9 Pseudo line printers 1 thru 7. 

10-16 Pseudo punches 1 thru 7. 

17-23 Pseudo readers 1 thru 7. 



ERROR: DEFAULT FORMID NOT FOUND AFTER STARTUP. 

Fatal error. The default FORMID was successfully verified when MRJE/3000 was started; 
however, the lookup table MRJETABL. PUB.SYS was altered after initialization. The default 
FORMID for either solicited or unsolicited output cannot be found. 

DIAL REMOTE number. 

The communications link has been initially established. Dial the number shown in the message 
and complete the connection. This message is printed only when the INP or SSLC is configured 
for a non -autodial switched line. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



old f Here ference EOF. FILE REBUILT? Y/N 

An end of file has been encountered while MRJEOUT was writing to oldfilereference. Use this 
procedure to recover: 

1. Issue RENAME oldfilereference ^neu}f Here ference from M?E. 

2. Issue BUILD oldfilereference from MPE, increasing the DlSC=numrec parameter, and 
duplicating all other specifications from newfilereference. 

3. Use FCOPY to move the contents of newfilereference into oldfilereference. 

4. Reply Y to this message. 

If you reply N to this message, MRJE/ 3 000 prints the next message at the console: 

To SAVE a job MRJE must terminate. The host will queue the job for 
retransmission. MRJECONTROL KILL must be issued by the operator after 
replying 'S' for SAVE. All jobs currently printing will be requeued on the 
host. To FLUSH a job MRJE will not terminate. The rest of the job will be 
lost. If the job is easily resubmitted or if MRJE should not terminate, 
reply 'F' for FLUSH. 



?SAVE or FLUSH job (S/F)? J lRETURNl or j lRETURNl 

FAILURE TO ACCESS MRJETABL. PUB.SYS 

Fatal error. An entry in the Configuration File references a record in MRJETABL. A 
Configuration File entry is delimited by single quotes: 

"^ for mid' 

Either MRJETABL does not exist, or it can not be opened. Insure that the lookup table does exist 
as an ASCII file with records no greater than 80 bytes. 

FAILURE TO ACQUIRE EXTRA DATA SEGMENT. 

Internal software error. Contact your Hewlett-Packard representative if this error can be 
duplicated. 

FAILURE TO ACQUIRE A LOCAL RIN. 

A RIN is a resource identification number. This is an internal software error. Contact your 
Hewlett-Packard representative if this error can be duplicated. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



MRJE FAILURE TO EXECUTE MPE "COMMAND" INTRINSIC. 

MPE Command Interpreter Error Message, 

COMMAND PARM = n 

MRJE FORMID = form 

MRJE THE FOLLOWING FILE EQUATION WAS ATTEMPTED: 

FILE jobname;file equation specifications 

MRJE USED DEFAULT FORMID OF default FOR JOB jobname 

MRJE USED OUTPUT PRIORITY OF 2. 

Warning. This message is displayed if an invalid record identified by form is found in the lookup 
table MRJETABL.PUB.SYS. MRJE/3000 uses the default standard form entry with a deferred 
output priority of 2 in such cases. To minimize the probability of this message occurring, use the 
MRJECONTROL VERIFY command to insure that each entry is a valid file equation record before 
starting MRJE. 

The message line COMMAND PARM = n concerns the MPE COMMAND intrinsic parameter PARM. The 
value oftt is the erroneous parameter number in the file equation. Consult the MPE Intrinsics 
Reference Manual for additional information on this parameter. 

FAILURE TO LOCK A LOCAL RIN. 

A RIN is a resource identification number. This is an internal software error. Contact your 
Hewlett-Packard representative if this error can be duplicated. 

FAILURE TO MOVE DATA FROM EXTRA DATA SEGMENT. 

Internal software error. Contact your Hewlett-Packard representative if this error can be 
duplicated. 

FAILURE TO MOVE DATA TO EXTRA DATA SEGMENT. 

Internal software error. Contact your Hewlett-Packard representative if this error can be 
duplicated. 

FAILURE TO OPEN DEFAULT FILE AFTER STARTUP 

Fatal error. Although the default destination file was verified at startup, the lookup table 
MRJETABL.PUB.SYS may have been modified The default form is no longer valid. 

FAILURE TO OPEN DEFAULT FORM 

MPE/ FILE SYSTEM error message 

MRJE ATTEMPTED THE FOLLOWING FILE EQUATION: 

FILE MRJETEST file equation specifications 

Fatal error. The FORMID from the Configuration File was found in the table MRJETABL but a 
file equation using this record and subsequent FOPEN could not be executed successfully. A file 
system error message and file equation attempted are also displayed. Check the record in 
MRJETABL. Insure that the file equation specification does not begin before column 9 in the 
record. 

FAILED TO OPEN UNSOLICITED OUTPUT DEVICE 

MRJE/3000 failed to open the unsolicited device and the printer process has terminated. Issue an 
MRJECONTROL KILL command. Then modify the Configuration File item for unsolicited 
output disposition to rectify the problem. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



FAILURE TO DELETE TEST SPOOLFILE. 

Warning. This message apears when MRJETABL and a default output file disposition refer to an 
entry in the table which is spooled. MRJE/ 3 000 opens, closes and deletes MRJETEST, a test 
spoolfile. This message can appear when the output priority in the file equation record is above 
the outfence for the device. The spoolfile can become ACTIVE after a spoolfile has been closed 
and before it is deleted. Once ACTIVE, the spoolfile cannot be deleted. So, the output priority 
parameter in the file equation record should always designate deferred output. 

FAILURE TO OPEN SOLICITED OUTPUT DEVICE. 

Fatal error. This error occurs when using MRJETABL. The fortnid specified for default solicited 
output destination. Configuration File items 20 or 27, refers to an invalid record in the lookup 
table. Correct the entry and retry. 

FINAL TERMINAL SIGNOFF 

The remote computer issued a sign off to MRJE. 

WARNING: FORMID NOT FOUND IN MRJETABL 

FORMID NOT FOUND = formname 

USED DEFAULT FORMID OF default FOR JOB jobname 

USED OUTPUT PRIORITY OF 2 

A formid could not be found in MRJETABL. Either MRJE/ 3 000 received a host setup message to 
mount formname for a printer, or a user submitted a job for which the SUBMIT print, punch or 
forms parameters were set to formname. In this situation MRJE/3000 automatically uses the 
default FORMID referenced by the unsolicited output disposition entry in the Configuration File 
at an output priority of 2. This file equation record can override the FOPEN output priority of 
specification MRJE/3000 if the output priority is indicated in the file equation. Contact the user 
affected. 

FWRITE ERROR {m) RECOVERY (Y/N)? 

File system error nn has taken place during execution of MRJEOUT. 

If you reply Y to this message, then MRJEOUT resumes processing. 

If you reply N to this message, the next message appears at the system console: 

To SAVE a job MRJE must terminate. The host will queue the job for 
retransmission. MRJECONTROL KILL must be issued by the operator after 
replying 'S' for SAVE. All jobs currently printing will be requeued on the 
host. To FLUSH a job MRJE will not terminate. The rest of the job will be 
lost. If the job is easily resubmitted or if MRJE should not terminate, 
reply 'F' for FLUSH. 



?SAVE or FLUSH job (S/F)? Ireturn) or j lRETURNl 

HOST BLOCK SEQUENCE {nl,n2). 

A block sequence error occurred on the CS device. Block n2 was received when block nl was 
expected. Normally, MRJE/3000 recovers from this condition. If the problem recurrs, contact 
your Hewlett-Packard representative. 

HOST BUFFER SIZE (nnnn) EXCEEDS MAXIMUM. 

The value specified in the MRJE/3000 Configuration File for the host buffer size is greater than 
2048. The MRJE Manager should alter Item 43 in the configuration file. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 

HOST ID IS TOO LONG 

When RUN MRJEMON ; INFO="/?" was issued, the h was more than one character long. 

HOST # NOT ENTERED FOR 3000 JOB §nnn . 

All output received from job nnn was sent to one of the unsolicited output device specified in 
MRJE/ 3000 Configuration File. 

INVALID BUFFER RECEIVED FROM HOST. 

The last buffer of data received from the host had contradictory or invalid control information. 
Contact your Hewlett-Packard representative. 

INVALID DEVICE FOR MRJEO. 

The logical device number configured in the MRJE/ 3 000 Configuration File for the pseudo line, 
Configuration File item 3, is not the same as the number configured into MPE for lOMRJEO. The 
MRJE/ 3000 Manager must change the logical device number in the Configuration File using the 
ALTER command. 

INVALID LDEV NUMBER n 

Logical device number «, referenced by MRJE, has not been configured within the system. 

INVALID UNIT NUMBER DETECTED BY MRJEOUT. 

Internal software error. Contact your Hewlett-Packard representative if this error can be 
duplicated. 

KILL ALREADY REQUESTED. 

The MRJECONTROL KILL message has already been issued, but it was unsuccessful. Subsequent 
KILL commands for the same host cause this message. If MRJE/ 3 000 does not disconnect the line, 
you may need to physically disconnect it. If MRJE/ 3 000 repeatedly fails to close the line after 
the KILL command is issued, contact your Hewlett-Packard representative. 

LOCKSEG FAILURE. 

LOCKSEG Intrinsic failure. Internal software problem. Contact your Hewlett-Packard 
representative. 

ff7 BLOCK SEQUENCE RECOVERY. EXPECTED BLOCK n2 . RECEIVED BLOCK «3. 

While data was being transmitted to the host system, block n3 was received when block n2 was to 
have been sent. There were nl blocks recovered. MRJE/3000 normally recovers from this 
condition. If the problem persists, contact your Hewlett-Packard representative. 

MRJE ERR137: MRJEOUT, OPEN FAILURE ON MRJETBL/? 

This error message can appear when Printer 1 is not configured for Output Management mode 
using MRJETABL, while other print or punch output devices are configured to run in this mode. 

Either all or none of the output processes should be configured to use MRJETABL for output 
routing. 

MRJELOGR, FINFO FAILURE {nn) ON MRJEDIR/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, JOB TRANSMITTED TO WRONG HOST. 

An HP3000 system configured with several host systems can transmit jobs to the wrong host if the 
same pseudo card reader is configured in more than one MRJE/3000 Configuration File. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



MRJELOGR, OPEN FAILURE {nn) ON $NULL. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, OPEN FAILURE (nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, OPEN FAILURE {nn) ON MRJEDIR/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, OPEN FAILURE {nn) ON MRJEJOB/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, READ FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, READ FAILURE {nn) ON MRJEDIR/?. 

File system error nn. If severe, contact your Hewlett-Packard representative 

MRJELOGR, READ FAILURE {nn) ON MRJEJOB/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, WRITE FAILURE {nn) ON MRJEDIR/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJELOGR, WRITE FAILURE {nn) ON MRJEJOB/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEMON, OPEN FAILURE {nn) ON OS DEVICE. 

The MRJE/ 3 000 monitor could not open the line. The CS error number {nn) identifies the reason 
for the failure. CS error codes are described in the Data Communications Handbook. 

MRJEMON, OPEN FAILURE {nn) ON $NULL. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEMON, OPEN FAILURE {nn) ON MRJEO. 

The MRJE/ 3 000 pseudo line monitor file could not be opened, (nn) specifies the MPE file system 
error number which identifies a reason for the failure. If the problem is severe, contact your 
Hewlett-Packard representative. 

MRJEMON, OPEN FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative 

MRJEMON, READ FAILURE {nn) ON CS DEVICE. 

The communication link to the host failed. The CS error number (nn) identifies the reason for the 
failure. CS errors are described in the Data Communications Handbook. If the problem is severe, 
contact your Hewlett-Packard representative. 

MRJEMON, READ FAILURE {nn) ON MRJEO. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEMON, READ FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 

MRJEMON, WRITE FAILURE (/?«) ON CS DEVICE. 

If this message appears as a WARNING, a communication problem developed and MRJE/ 3 000 sent 
a SIGNOFF command prior to disconnecting the line. The host system probably has accepted the 
command and is closing the communications link. 

If this message appears as an ERROR , the communications link failed unexpectedly. The CS error 
number references the reason for the failure. These errors are described in the Data 
Communications Handbook (5957-5634). Contact your Hewlett-Packard representative, if such 
errors persist. 

MRJEMON, WRITE FAILURE (/?«) ON MRJEO. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEMON, WRITE FAILURE (ww) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, CLOSE FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, FINFO FAILURE {nn) ON MRJE'PNLP. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, FINFO FAILURE {nn) ON MRJEOUT 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON $NULL. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON MRJE'PNLP. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON MRJEDIR/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON MRJEJOB/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, OPEN FAILURE {nn) ON MRJEOUT. 

MRJE/ 3000 couldn't open a User's output file. Output destined for the file was sent to the 
unsolicited output device. This message appears when Output Management is not being used. File 
system error nn was encountered. If severe, contact your Hewlett-Packard representative. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



MRJE ERROR: MRJEOUT, OPEN FAILURE {nnn) ON MRJEOUT 

File System Error Message (FSERR nnn) 

MRJE FORMID = formname 

MRJE The following file equation was attempted: 

FILE jobname;file equation specifications 

MRJE Used default FORMID of default for job jobname 

MRJE Used output priority of 2. 

MRJE/3000 failed to perform an FOPEN successfully using a file equation record trom 
MRJETABL referenced by the form formname. MRJE/3000 uses the default FORMID from the 
table with an output priority 2. Use an MRJECONTROL VERIFY command from MPE to verify 
that each entry is a valid file equation record before starting MRJE. 

MRJEOUT, READ FAILURE {nn) ON MRJE'PNLP. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, READ FAILURE {nn) ON MRJECON/?. 

File system error nn. If severe, contact your Hewlett-Packard representative. 

MRJEOUT, READ FAILURE {nn) ON MRJEDIR/?. 

File system error nn. Contact your Hewlett-Packard representative. 

MRJEOUT, READ FAILURE {nn) ON MRJEJOB/?. 

A message with ««=0 indicates that unsolicited output was received that does not belong to any 
entry in the Job Log File. A message with nn 9^ indicates that an internal software error has 
occurred. In the latter case, contact your Hewlett-Packard representative. 

MRJEOUT, WRITE FAILURE {nn) ON MRJE'PNLP. 
This message should be ignored. 

MRJEOUT, WRITE FAILURE {nn) ON MRJEOUT. ^, vt .p 

MRJE/3000 couldn't write to a user's file. Output for the file is irrecoverable. Notify 
MRJE/3000 users that output was lost. Contact your Hewlett-Packard representative. 

MRJESTR/? FILE DOES NOT EXIST ..„Tr.c^ot,f u , a 

An MRJECONTROL START,/! has been issued, but there is no Stream File MRJESTRft tor nost la 
h. The stream file is used to initiate MRJE/3000 communication with the host system. 

MRJETABL RECORDS > 260 BYTES 

Fatal error. Records in this file must not exceed 260 bytes. Rebuild the file. 

NO 30G0# FOR HOST JOB# nnnn > jobname. 

Internal software problem. All output received for host JOB# nnnn was sent to the unsolicited 
output devices specified in the MRJE/3000 Configuration File. If the problem is severe, contact 
your Hewlett-Packard representative. 

NO SYSTEM BUFFER FOR SIGNOFF. 

An MRJECONTROL SIGNOFF command failed because no HP 3000 system buffers were 
available. Wait and try again. If this problem occurs frequently, contact your Hewlett-Packard 
representative. 

PRINTER TERMINATING. ^ ^ wi^rr: /annn 

Internal software error. A printer or punch output process terminated, but MRJE/ 3 000 cannot 
determine which one. Contact your Hewlett-Packard representative. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 

PRINTER n TERMINATING. 

Internal software error. The MRJE/3000 output process corresponding to printer n terminated. 

1- If no SIGNON COMPLETED message has been 

received, enter this command: 

MRJECONTROL KILL [,hostid] 

^- If a SIGNON COMPLETED message has been 

received, enter this command: 

MRJECONTROL SIGNOFF [,hostid] 

3- Always contact your Hewlett-Packard 

representative. 

PUNCH n TERMINATING. 

Internal software error. The MRJE/3000 output process corresponding to punch n terminated. 

^- If no SIGNON COMPLETED message has been 

received, enter this command: 

MRJECONTROL KILL [,hostid] 

^' If a SIGNON COMPLETED message has been 

received, enter this command: 

MRJECONTROL SIGNOFF [,hostid] 

^- Always contact your Hewlett-Packard 

representative. 

SIGNOFF ALREADY REQUESTED. 

The MRJECONTROL SIGNOFF command has already been entered. If the SIGNOFF command is 
issued while the host is transmitting, transmission continues until the current data set has been 
received; then the line is disconnected. 

SIGNON COMPLETED. 

The MRJECONTROL START command has successfully executed and the communication link is 
now open. If jobs have been submitted, MRJE/3000 automatically begins transmitting data and 
accepting output. 

SYSTEM ALREADY ACTIVE. 

The MRJECONTROL START command was issued for a host that is already connected. 

SYSTEM NOT ACTIVE. 

An MRJECONTROL SIGNOFF (or KILL) command was issued for a host that is not connected. 
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Table 6-3. MRJE Messages Sent to System Console (continued) 



TERMINATING. 

The MRJE/ 3 000 monitor process terminated. When printed without any accompanying ERROR 
or WARNING message, the termination was normal. 

UNLOCKSEG FAILURE. 

The UNLOCKSEG intrinsic failed. Internal software error. To reclaim the stack of the line 
monitor, COOLSTART the system. Contact your Hewlett-Packard representative. 

ZSIZE ERROR. 

The ZSIZE intrinsic failed. Internal software error. Contact your Hewlett-Packard 
representative. 
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MRJE/3000 MESSAGE CATALOG 



The message catalog file is used by MRJE/3000 for error messages and information messages. 
MRJECAT. PUB. SYS is the message catalog for MRJE/3000. The method of maintaining file 
MRJEC AT. PUB. SYS is discussed in the MPE Intrinsics Reference Manual, in the discussion of the MPE 
Message System. The contents of file MRJEC AT. PUB. SYS are shown in Table 6-4, MRJE/3000 Message 
Catalog. All parameters passed to messages in the catalog are shown as grey exclamation marks (1). 

Table 6-4, MRJE/3000 Message Catalog 
$ Note: if you plan to change the content of the file, please 
observe the followings: 

The file must be built from a standard numbered editor file. 
No message can be longer than 1024 characters 
No line of a message can be longer than 56, 66 and 66 for 
the master console, subsystem and help facility respec. 
"\&" must be put at the end of a line of a message except 

the last line to signal as a delimiter of the line. 
Never delete or add any "jl" into the file 
Never change any message or set number within the file 
RUN makecat .pub.sys to rebuild the MRJECAT file. 

Before running MAKECAT you'll need two file equats: 
a). FILE input=your'new'f ile 
b). FILE catalog=mrjecat . pub. sys 
Then run MAKECAT. PUB 
Then SAVE mrjecat.pub 
Refer to MPE Intrinsic Message System for more information 



$ 




$ 


1) 


$ 


2) 


$ 


3) 


$ 




$ 


4) 


$ 




$ 


5) 


$ 


6) 


$ 


7) 


$ 




$ 




$ 




$ 




$ 




$ 


8) 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



$SET 1 MESSAGE 1 TO 62 FOR MASTER CONSOLE 

1 MRJE I ERROR: CONFIGURED BUFFER SIZE INVALID 

MRJE ! ERROR: CREATE FAILURE ON I PROCESS 
DIAL REMOTE I 



MRJE ! 

MRJE ? ERROR: LOGSEG FAILURE 

MRJE ! SIGNON COMPLETED 

MRJE ! ERROR: HOSTBUFFER SIZE (|) EXCEEDS MAXIMUM 

CONFIGURATION 
MRJE ! WARNING: |: BLOCK SEQUENCE ERROR RECOVERY, 



\& 



RECEIVED BLOCK I 



EXPECTED BLOCK I 

8 MRJE ! ERROR: ZSIZE ERROR 

9 MRJE ! ERROR: UNLOCKSEG FAILURE 

10 MRJE ! ERROR: NO SYSTEM BUFFER FOR SIGNOFF 

11 MRJE f MRJE TERMINATING. . . 

12 MRJE t ERROR: INVALID DEVICE FOR MRJEO 

13 MRJE t ERROR: MRJE ALREADY ACTIVE. 
ERROR: CREATE FAILURE ON MRJEMON 
ERROR: ACTIVATE FAILURE ON MRJEMON 
WARNING: SIGNOFF ALREADY REQUESTED 

17 MRJE ! WARNING: KILL ALREADY REQUESTED 

18 MRJE ! WARNING: SYSTEM NOT ACTIVE 
ERROR: HOST # NOT ENTERED FOR 3000 JOB# | 

NO 3000# FOR HOST JOB# MM 



14 MRJE 

15 MRJE 

16 MRJE 



19 MRJE 

20 MRJE 

21 MRJE 



ERROR: 
ERROR: 



i TERMINATING. 



22 MRJE ? ERROR: DATA RECEIVED FOR INVALID UNIT# I 



23 MRJE 

24 MRJE 

25 MRJE 



ERROR: INVALID BUFFER RECEIVED FROM HOST 
ERROR: (MRJELOGR) JOB TRANSMITTED TO WRONG HOST 
ERROR: SON PROCESS DEAD 



26 MRJE t WARNING: MRJECONTROL KILL REQUESTED 

27 MRJE ? FINAL TERMINAL SIGNOFF 

28 MRJE t ERROR: MRJESTR| DOES NOT EXIST 

29 MRJE ? ERROR: CS, SM AND OP REQUIRED TO RUN MRJEMON 



30 MRJE 

31 MRJE 

32 MRJE 

33 MRJE 

34 MRJE 

35 MRJE 

36 MRJE 

37 MRJE 

38 MRJE 



ERROR: HOST ID 



IS TOO LONG 
ERROR: INVALID LDEV NUMBER i 

ERROR: Failure to access file MRJETABL.PUB.SYS 
ERROR: Config FORMID not found in MRJETABL. 
ERROR: Failure to open default form. 
WARNING: Failure to delete test spoolfile. 
ERROR: MRJETABL.PUB.SYS records > 260 bytes. 
Failure to execute MPE "COMMAND" Intrinsic. 
WARNING: FORMID not found in MRJETABL.PUB.SYS. 

39 MRJE t Failed to open unsolicited output device. 

40 MRJE t WARNING: FWRITE error. 

41 MRJE ? Output process terminating per operator \& 
request. 

42 MRJE 

43 MRJE 

44 MRJE 

45 MRJE 
To SAVE 



Failure to acquire a local RIN. 

The following file equation was attempted: 

Used output priority of 2. 

\& 

job, MRJE must terminate. The host will queue\& 
the job for retransmission. MRJECONTROL KILL must be \& 
issued by the operator after replying 'S' for SAVE. All \& 
jobs currently printing will be requeued on the host. \& 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



To Flush a job» MRJE will not terminate. The rest of \& 
the job will be lost. If the job is easily resubmitted \& 
or if MRJE should not terminate, reply 'F' for FLUSH. 



46 MRJE 

47 MRJE 

48 MRJE 

49 MRJE 

50 MRJE 

51 MRJE 

52 MRJE 

53 MRJE 

54 MRJE 



Failure to lock a local RIN. 
Failed to acquire extra data segment. 
Failed to move data to extra data segment. 
Failed to move data from extra data segment. 
Error: Default FORMID not found after startup. 
Failure to open solicited output device. 
Invalid unit number detected by MRJEOUT. 
Configured record width is invalid. 
Failure to open default file after startup. 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



$SET 2 MESSAGE 1 TO 62 FOR MRJE SUBSYSTEM 

1 MANAGER CAPABILITY IN EFFECT 

2 USER CAPABILITY IN EFFECT 

3 FILE ALREADY EXISTS REPLY "YES" TO RECREATE. 

4 FOLLOWING MUST BE INITIALIZED IN CONFIGURATION FILE: 

5 DEFAULT HOST ASSUMED 

6 IS OFFLINE 

7 VERIFY CANCEL WITH "YES". 

8 IS CURRENT HOST MACHINE 

9 WARNING: SIGNOFF CARD FOUND IN INPUT. NOT TRANSMITTED. 

10 FILES CREATED. 

11 SUCCESSFULLY ALTERED 

12 IS ON LINE 

13 ENTER INPUT ENDING WITH "MRJEOD" 

14 END OF FILE 

15 WARNING: MRJEOD FOUND IN INPUT. CARD IS NOT TRANSMITTED. 

16 CAN'T BE CLOSED 

17 NOT FOUND 

18 JOBLOG IS EMPTY 

19 : DUPLICATE JOBNAMES IN JOBLOG. CANCEL REFUSED. A DISPLAY 

20 OF JOBS WITH THIS NAME WHICH YOU OWN (IF ANY) FOLLOWS: 

21 NOT SUBMITTED 

22 JOB NOT CANCELED. 

23 IS NOT YOUR JOB. 

24 NOT PURGED. 

25 NO JOBLOG ENTRY. 

26 GET PRIVILEGED MODE FAILURE. FATAL ERROR. 

27 GET USER MODE FAILURE. FATAL ERROR. 

28 JOB ALREADY CANCELED. 

29 CANCELED. 

30 CANCEL COMMAND WILL BE SENT TO HOST. 

31 INTERACTIVE TERMINAL REQUIRED FOR HOST CONSOLE COMMANDS. 

32 WARNING: HOST COMMAND CARD FOUND IN INPUT-NOT TRANSMITTED. 

33 ITEM 4 ONLY DISPLAYED FOR MANAGER. 

34 DISPLAY COMMAND WILL BE SENT TO HOST. 

35 FREE ENTRIES NOW EXIST. 

36 OLD JOBS IN THIS FILE. 

37 OLD JOBS PURGED THUS FAR. 

38 JOBS ARE IN THE JOB LOG. VERIFY PURGE WITH "YES" 

39 COMPLETELY PURGED OF ALL JOB ENTRIES. 

40 IS OFFLINE. HOST CONSOLE COMMAND CAN'T BE SENT. 

41 NOT ALTERED 

42 NO SPOOL FILE FOUND. 

43 SPOOL FILE DELETED. 

44 SPOOL FILE NOT IN READY STATE. UNABLE TO DELETE. 

45 FORM ID MUST CONSIST OF FROM 1 TO 8 CHARACTERS. 

46 MISSING RIGHT PARENTHESIS 

47 MANAGER CAPABILITY REQUIRED FOR THIS COMMAND 

48 "NOTRANSLATE" REQUIRED 

49 READER SPECIFIED TWICE. 

50 INVALID COMMAND 

51 INVALID HOSTID. MUST BE ALPHANUMERIC, <=8 CHARS 

52 PRINT SPECIFIED TWICE 

53 PUNCH SPECIFIED TWICE 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



54 INVALID HOST SYSTEM 

55 INPUT MUST BE NUMERIC 

56 DIGITS ARE THE MAX ALLOWED FOR THIS NUMBER 

57 FORMS SPECIFIED TWICE 
58 

59 DIGIT OR SPECIAL CHARACTER REQUIRED. 

60 LOGICAL DEVICE NUMBER OR DEVICE CLASS REQUIRED 

61 INVALID DEVICE CLASS SPECIFICATION 

62 NO CLOSING QUOTE ON DEVICE CLASS NAME 

63 INVALID FILE EQUATION SPECIFICATION. NAME MUST BE LESS THAN OR \& 
EQUAL TO 7 CHARACTERS. PLEASE CONSULT YOUR SYSTEM ADMINISTRATOR \& 
FOR MORE DETAILS. 

64 INVALID SUBMIT PARAMETER 

65 INVALID ACTUAL FILE DESIGNATOR 

66 IS THE MAX LEVEL OF NAMES IN THIS ACTUAL FILE DESIGNATOR 

67 EMBEDDED BLANKS NOT ALLOWED IN QUALIFIED NAME 

68 IS THE VALID RANGE FOR THIS PARAMETER. 

69 "ALL" OR "OLDJOBS" ARE ONLY VALID PURGE PARAMETERS. 

70 "BS", "CS", "DS" OR "ES" REQUIRED. 

71 (CURRENT CMD CHAR) MUST BE FIRST CHAR IN USER HOST CMD. 

72 COMMA OR NUMBER REQUIRED 

73 ONLY 3 PARAMETERS ARE ALLOWED 

74 NUMERIC PARAMETER EXPECTED 

75 DAYS, HOURS, MINS CAN'T ALL BE ZERO 

76 HOSTNAME MUST START WITH SAME CHAR AS HOSTID 
77 

78 INVALID PARAMETER FOR DISPLAY COMMAND 

79 Integer from to 255 required. 

80 ITEM NUMBER REQUIRED 

81 $STDIN,$STDINX,$OLDPASS ARE ONLY SYSTEM INPUT FILES ALLOWED 

82 NOTRANSLATE CAN'T BE SPECIFIED FOR $STDIN/$STDINX 

83 EXTRANEOUS INFORMATION AFTER VALID ITEM 

84 INVALID JOBNAME--TOO LONG 

85 INVALID SPECIAL CHARACTER 

86 COMMA OR SLASH REQUIRED TO SEPARATE PARAMETERS. 

87 Invalid output file specification. Valid designations are\& 
FORMID record in MRJETABL using single quotes (')\& 

Device Class using double quotes (") \& 

Device Number \& 

Actual File Designator \& 

Formal File Designator using exclamation mark (i)\& 

Zero (0) 

88 INPUT FILE NAME(S) REQUIRED 

89 NO BLANKS ALLOWED IN FORMAL FILE DESIGNATOR 

90 MAXIMUM OF 5 INPUT FILES ALLOWED 

91 INVALID KEYWORD 

92 PARAMETERS REQUIRED 

93 NO PARAMETERS ALLOWED 

94 IS THE MAXIMUM NUMBER OF CHARACTERS FOR THIS PARAMETER. 

95 INVALID OCTAL NUMBER 

96 IS THE ONLY VALID CONSOLE COMMAND. 

97 COMMA REQUIRED TO SEPARATE PARAMETERS 

98 "YES" OR "NO" REQUIRED 

99 FORM ID MUST BE TERMINATED WITH A SINGLE QUOTE ('). 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



100 IS AN INVALID PSEUDO LINE MONITOR DEVICE. FATAL ERROR. 

101 THIS ITEM NOT DYNAMICALLY CONFIGURABLE. 

102 STANDARD INPUT FILE CAN'T BE OPENED. FATAL ERROR. 
103 

104 CAN'T BE WRITTEN 

105 CAN'T BE CLOSED. FATAL ERROR. 

106 You must log on as MANAGER. SYS to use this command. 

107 VALID RESPONSE MUST BE GIVEN 

108 CAN'T BE WRITTEN TO HOST READER 

109 CAN'T BE READ 

110 DIRECTORY FULL. NO FURTHER JOBS CAN BE SUBMITTED. 

111 CONFIGURATION FILE SET C/a^NNOT BE ACCESSED. 

112 IS NOT YOUR JOB. 

113 NO NEW FILES CREATED. 

114 CONTINUATION LINE EXPECTED 

115 : OUTPUT FILE DOES NOT EXIST 

116 NO FILE DESIGNATOR ON ##FD CARD. 

117 CTRANSLATE FAILED 

118 CAN'T BE OPENED. 

119 READER CANNOT BE CLOSED 

120 NO JOB CARD FOUND. 

121 CAN'T BE POSTED 

122 END OF FILE ON $STDINX. FURTHER INPUT IMPOSSIBLE. FATAL ERROR. 

123 ##FD CARDS NOT PERMITTED IN LEVEL 2 FILE 

124 NO JOBLOG ENTRY. 

125 CAN'T BE CANCELED. 

126 IS OFFLINE. JOB CAN'T BE CANCELED AT HOST. 

127 HOST CONSOLE COMMAND CAN'T BE WRITTEN. 

128 HOST CONSOLE CAN'T BE OPENED. 

129 UNABLE TO CLOSE $STDINX. HOST CONSOLE COMMANDS CAN'T BE SENT. 

130 STANDARD INPUT FILE CAN'T BE OPENED FOR NOWAIT I/O. 

131 CONTROL-Y IS THE ONLY VALID INPUT DURING HOST COMMAND PROCESSING, 
132 

133 BUT NOT IN JOBLOG. FATAL ERROR. 

134 JOB CAN'T BE CANCELED AT HOST FOR NON- INTERACTIVE USER. 

135 NOT PURGED. 

136 DIRECTORY/JOBLOG UPDATE CAN'T BE COMPLETED. FATAL ERROR. 

137 CAN'T^BE CANCELED DUE TO A PREVIOUS 3000 SYSTEM FAILURE 

138 *** ITEM NOT USED WITH THIS HOST SYSTEM. 

139 HOST BUSY. CONSOLE COMMAND NOT SENT 
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Table 6-4, MRJE/3000 Message Catalog (continued) 



$SET 3 MESSAGE 1 TO 62 FOR HELP FACILITY 

1 S[UBMIT] infilel [(N[,T])] [, infileS [ (N [ ,T] ) ] ] ]\& 

[; R[eacler]=pseudo reader] [; PR[INT]=printf ile [(N)]]\& 

[; PU[NCH]=punchfile [(N)] [; F[ORMS]=formf ile [(N)]]\& 

Submit a job or several jobs for transmission. Parameters are:\& 

(N) = NOTRANSLATION from ASCII to EBCDIC for infiles, or\& 
NOTRANSLATION from EBCDIC to ASCII for print file,\& 
punch file or formsfile.\& 
(T) = only first job card is recognized. \& 

MRJE manager capability required.\& 
Infile = 5 infiles may be specified. \& 
Print, punch or forms file = may be any of the following:\& 

FORMID record in MRJETABL using single quotes (')\& 

Logical device class using double quotes (")\& 

Logical device number\& 

Actual file designator\& 

Formal file designator using exclamation mark (i)\& 

Zero (0)\& 
Note; the formal file designator must be defined by the\& 
system administrator. 

2 D[ISPLAY] [H[OST], J[OBLOG] {job#, jobname, joblist}, 0[LDJOBS], \& 

S[TATUS], C[ONFIG] {item#, itemlist} ] \& 

Display job and system information. \& 

DIRECTORY = list the contents of the job directory. \& 

HOST = list the current host machine. \& 

JOBLOG = information about jobs. (The default option). \& 
OLDJOBS = display canceled or time-out jobs. \& 

STATUS = display the status of the current host line. \& 
CONFIG = list the contents of the configuration file. 

3 C[ANCEL] [J[OBS]] {job#, jobname, joblist} \& 
Cancel one or more jobs and note the event in the job log file. \& 
JOBS = optional parameter. \& 
job# = number MRJE/3000 assigned to a job at submission time.\& 
jobname = the name on a JOB card in an input file. \& 
joblist = list job names and/or job numbers. 

4 E[XIT] command is used to exit the subsystem. 

5 A[LTER] {item#, itemlist}. \& 

You must have System Supervisor (OP) capability to use ALLTER.\& 
Specifies items in the configuration file are to be changed. \& 
item# = number assigned an entry in the configuration file. \& 
itemlist = a list of item numbers. 

6 P[URGE] {0[LDJOBS], A[LL]}.\& 
Purges entries from a job log file.\& 

System Supervisor (OP) capability is required to use PURGE OLD.\& 
You must log on as MANAGER. SYS to use PURGE ALL.\& 
Oldjobs = Purge entries for cancelled and timed-out jobs. 

7 H[OST] [hostid].\& 

Select a particular host machine to be the current host machine. 

8 N[EW] [hostid] . \& 

You must log on as MANAGER. SYS to use this command. \& 
Creates or recreates the configuration, joblog and directory \& 
files for a given host machine. \&; 

hostid = Used in a multiple host environments. Hostid can\& 
have up to eight alphanumeric characters. If\& 
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several machines are defined, each host id has a \& 
unique first character. 
9 Commands are: Alter, Cancel, Display, Host, New, Purge, Submit \& 
Enter HELP <<command>> for the syntax of the <<command>> 
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This describes the contents of the MRJE/3000 Configuration File. 

SUMMARY OF CONFIGURATION FILE ENTRIES 

This information is provided for each Configuration File entry in Table A-1, Configuration File Contents. 

• ENTRY NUMBER AND DESCRIPTION: MRJE/3000 accesses entries in the file by number. This is also 
called item. 

• ENTRY /TYPE: These are literal entries or character types. 

UPPER CASE a Hteral entry 

n a numeric entry. Acceptable range of values is shown. 

an an alphanumeric entry. 

sp special character. Non-alphanumeric. 

* One of the following: 

• The numeric value of a Logical Device Number (LDN). 

• An alphanumeric value, enclosed in double quotation 
marks indicating a Device Class (DC), as in the "devclass" 
string. 

• An actual file designator (AFD), as in 
filename, groupname. acctname. 

• An exclamation mark followed by a seven character 
alphanumeric formal file designator, indicating 
predefined routing, as in the \filenam string. 

• An alphanumeric value, enclosed in single quotation 
marks indicating a FORMID entry in MRJETABL, as in 
the ' formname' string. 

• ASC 1 1 BYTES : Indicates the maximum number of characters that can be entered. 

• DEFAULT VALUE: When MRJE/3000 provides more than one value, the values are identified by Job 
Entry System. 
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• NOTES 

Number 

1. 

2. 
3. 



Meaning 

The ALTER command can not alter this entry. To change it, you must 
rebuild the Configuration File. Use the NEW command. 

This entry is displayed to MRJE/3000 Managers only. 

The first character of the User host console command must be identical to 
entry number 7. MRJE/3000 automatically alters this when entry number 
7 is altered. 

This entry is automatically changed whenever Item 5- -Job Entry 
Subsystem --is changed. The new value is the default value for the new 
Subsystem. 

If this entry is a positive number, then MRJE/3000 passes along all nnn 
lines, even if it fails to recognize its value as a banner. However, if this 
entry is a negative number, then MRJE/3000 discards nnn lines of print, or 
card punch images. 

6- RSCS may use this item in another manner, or not at all. See the 

description of the Configuration File item following Table A-1. 

A description of each Configuration File item follows Table A-1. 



4. 



5. 
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Table A-1. MRJE/3000 Co 


nfiguration File 


Entries 




ENTRY NUMBER AND DESCRIPTION 


ENTRY/ 


ASCII 


DEFAULT 


NOTES 




TYPE 


BYTES 


VALUE 




1 . Host system ID 


an 


8 


(none) 


1 


2. Pseudo console 


n 


3 


(none) 




(logical device number) 


0-999 








3. Pseudo line monitor 


n 


3 


(none) 




(logical device number) 


0-999 








4. Signon card image 


an, sp 


80 


(none) 


2 


5. Job Entry Subsystem on 


HASP, 


4 


(none) 




host 


JES2, 
JESS, 
ASP, or 
RSCS 








6. User host console 


an 


10 


(none) 


3,6 


command (s) 










7. Host console command 


n or sp 


1 


$ (HASP) 


4 


character 






$ (JES2) 

* (JESS) 

* (ASP) 
$ (RSCS) 




8. Number of lines to 


n 


2 


10 (HASP) 


4,5,6 


check for print banner 


-999 


An 


60 (JES2) 






to 


inte- 


60 (JESS) 






+999 


ger 


60 (ASP) 
35 (RSCS) 




9. Number of cards to check 


n 


2 


1 


4,5,6 


for punch banner 


-999 

to 
+999 


An 
inte- 
ger 






10. For HASP and JES2--column 


n 


3 


S3 (HASP) 


4,6 


where host-assigned job 


6-129 




14 (JES2) 




number begins in the 










print banner 










For JES3 and ASP--width of 


n 


3 


13 (JESS) 


4,6 


a block letter in the 


6-129 




13 (ASP) 




print banner 










Not used by RSCS. 
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Table A-1 . MRJE/3000 Configuration Fi 


le Entries (contint 


jed) 


ENTRY NUMBER AND DESCRIPTION 


ENTRY/ 
TYPE 


ASCII 
BYTES 


DEFAULT 
VALUE 


NOTES 


11. Column where job name 
begins in print banner 
(Not used by JESS, or ASP) 


n 
0-124 


3 


79 (HASP) 
19 (JES2) 
13 (RSCS) 


4,6 


12. Column where host-assigned 
job number begins in the 
punch banner. Not used 
by RSCS. 


n 
1-76 


2 


44 (HASP) 
44 (JES2) 
21 (JES3) 
21 (ASP) 


4,6 


13. Column where job name 
begins in punch banner. 


n 
0-72 


2 


(HASP) 
(JES2) 
35 (ASP) 
(RSCS) 


4,6 


14. Not used by JES2, HASP or 
RSCS. 








6 


For JES3--column where 
JOB NAME begins in 
special forms console 


n 
1-120 


3 


18 (JES3) 




message 










For ASP--column where 
JOB begins in special 
forms console message 


n 
1-120 


3 


16 (ASP) 




15. Column where JOB 

begins in console job 
received message. 
Not used by RSCS. 


n 
1-99 


2 


11 (HASP) 
10 (JES2) 
18 (JES3) 
16 (ASP) 


4,6 


16. Column where job name 
begins in console job 
received message 
Not used by RSCS. 


n 
1-99 


2 


35 (HASP) 
28 (JES2) 
30 (JES3) 
28 (ASP) 


4,6 


17. Column where ON begins 
in console job received 
message. Not used by JES3, 
ASP, or RSCS. 


n 
1-99 


2 


20 (HASP) 
37 (JES2) 


4,6 


18. Maximum number of Job Log 
file entries 


n 
25-1000 


4 


100 


1 


19. Default device for input 
to MRJE/3000 (LDN or DC) 


* 


10 


"MRDR1" 
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Table A-1. MRJE/3000 Configuration File Entries (continued) 



ENTRY NUMBER AND DESCRIPTION 


ENTRY/ 
TYPE 


ASCII 
BYTES 


DEFAULT 
VALUE 


NOTES 


20. Default device for printer 
output from MRJE/3000 (LDN, 
DC, AFD, or FORMID) . 


* 


10 


"LP" 


6 


21. Unsolicited print dis- 
position, printer 1 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 




22. Unsolicited print dis- 
position, printer 2 (LDN, 
DC, AFD, or FORMID) 


4f 


26 


"LP" 


6 


23. Unsolicited print dis- 
position, printer 3 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 


6 


24. Unsolicited print dis- 
position, printer 4 (LDN, 
DC, AFD, or FORMID) 


» 


26 


"LP" 


6 


25. Unsolicited print dis- 
position, printer 5 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 


6 


26. Unsolicited print dis- 
position, printer 6 (LDN, 
DC, AFD, or FORMID) 


« 


26 


"LP" 


6 


27. Unsolicited print dis- 
position, printer 7 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 


6 


28. Default device for punch 

output from MRJE/3000 (LDN, 
DC, AFD, or FORMID) 


« 


10 


"LP" 


6 


29. Unsolicited punch dis- 
position, punch 1 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 




30. Unsolicited punch dis- 
position, punch 2 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 


6 


31. Unsolicited punch dis- 
position, punch 3 (LDN, 
DC, AFD, or FORMID) 


* 


26 


"LP" 


6 
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Table A-l . MRJE/3000 Configuration File Entries (continued) 



ENTRY NUMBER AND DESCRIPTION 


ENTRY/ 
TYPE 


ASCII 
BYTES 


DEFAULT 
VALUE 


NOTES 


32. Unsolicited punch dis- 
position, punch 4 (LDN, 
DC, AFD, or FORMID) 


# 


26 


"LP" 


6 


33. Unsolicited punch dis- 
position, punch 5 (LDN, 
DC, AFD, or FORMID) 


4f 


26 


"LP" 


6 


34. Unsolicited punch dis- 
position, punch 6 (LDN, 
DC, AFD, or FORMID) 


« 


26 


"LP" 


6 


35. Unsolicited punch dis- 
position, punch 7 (LDN, 
DC, AFD, or FORMID) 


4f 


26 


"LP" 


6 


36. MRJE/3000 output process 
priority 


BS, CS, 
OS, or ES 


1 


ES 




37. Number of characters to 
test in job name 


n 
0-8 


1 


8 




38. Language ID for data 
translation 


nnn 

to 

255 


1 
An 
integer 







39. Host system phone number 


n 


16 


(none) 




40. Time communications line 
opened (set by MRJE/3000 
when MRJECONTROL START 
executes) 


(no user 
input) 


6 


(none) 


1 


41. Time communications line 
closed (set by MRJE/3000 
when MRJECONTROL SIGNOFF 
or KILL executes) 


(no user 
input) 


7 


(none) 


1 


42. Maximum time job remains 
active in Job Log after 
transmittal (days ,hrs,min) 


n 


6 


1/0/0 


6 


43. Host buffer size (bytes) 


n 
100-2000 


5 


400 





A-6 



Configuration File Contents 

DESCRIPTION OF CONFIGURATION FILE ENTRIES 

Entry: Description 

1. Host system ID: This name identifies the host for which this Configuration 
File is being built. MRJE/3000 users access the host system by using this 
name or the first character of this name. 

2. Pseudo console: The logical device number of the MRJE/3000 pseudo 
console. This should be configured as Unit 2. See Configuring MPE to 
Include MRJE/3000, in Appendix C. 

3 Pseudo line monitor: The logical device number of the first line monitor 

configured in MPE for this communications line. This should be configured 
as Unit 0. See Appendix C, Configuring MPE to Include MRJE/3000 . 

4. Signon card image: An exact image of the identification card sent by 
MRJE/3000 to the host system. The format of this card is specified by 
host system personnel and typically begins with /*SIGNON or LOGON . 

5. Job Entry Subsystem on Host: Specifies the name of the Job Entry 
Subsystem in use at the remote host site. This entry implicitly defines the 
formats of the host cancel and display commands, the signoff card image, 
and the host console commands that can be sent through a job stream. The 
formats are: 

JES3 
HASP: JES2: or ASP: RSCS: 

cancel $CJ n^n $CJ «,P *F,J=(/?),C Not applicable. 

display $DJ n $DJ n *I,J=(m) Not applicable. 

command /*$ /*$ /** /*$ 

An /? is a host job number. 

A signoff is always /*SIGNOFF. 

This entry also implicitly defines defaults for entries 7 through 1 7 in the 
Configuration File. 



NOTE 



Entry 6, User host console command, is not 
affected by this entry. 
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User Host Console Command: This entry specifies the characters that can be 
typed by a User and transmitted to the host system as a host system console 
command. If the host Job Entry Subsystem is either HASP or JES2 and a 
dollar sign ($) is entered here, any command beginning with $ may be issued 
by the User. For ASP and JES3, if an asterisk is entered here, the User may 
issue any command beginning with an * character. 

For RSCS: this is used by MRJE/3000 to indentify user entries intended for 
the host system. This character is removed before transmitting the 
command to conform with host system requirements. 

Host console command character: This is the first character of all host 
console commands. If this is altered, item 6 is automatically changed so that 
the new command character is inserted in the User's host command. Also 
changed are the host cancel and display commands and the host command 
image, such as /*$, which begins JES2 and HASP commands. 

For RSCS: this is used by MRJE/3000 to indentify user entries intended for 
the host system. This character is removed before transmitting the 
command to conform with host system requirements. 

Number of lines to check for print banner: When print output is returned 
to MRJE/3000 from a host system, MRJE/3000 must identify the data set 
and route it to the appropriate output device or file. Each output data set 
is separated from others by a banner page. This entry specifies how many 
lines to scan for the print banner or separator page. Scanning begins at the 
first line following the end of the previous data set. 

MRJE/3000 typically prints the banner whether or not it is decoded 
successfully, recognizing the job name and number. When you specify a 
negative number for this item {-nnn), MRJE/3000 discards \nnn \ lines, if 
it fails to recognize a banner. When you specify a positive number for this 
item, MRJE passes along as output those nnn lines it has failed to recognize. 

For RSCS: Only the n line is checked. Lines 1 through n-1 are not 
checked, but ignored. Use MRJEMON with the DBUG'LINES secondary 
entry point to identify the number of banner lines sent with a data set. 

Number of cards to check for punch banner: When punch output is 
returned to MRJE/3000 from a host system, MRJE/3000 must identify the 
data set and route it to the appropriate output device or file. Each output 
data set is separated from others by a banner. This entry specifies how 
many cards to scan for the punch banner or separator card(s). Scanning 
begins with the first card following the end of the previous data set. 

MRJE/3000 typically punches the banner whether or not it is decoded 
successfully, recognizing the job name and number. When you specify a 
negative number for this item {-nnn), MRJE/3000 discards |nnrt| card 
images, if it fails to recognize a banner. When you specify a positive 
number for this item, MRJE passes along as output those nnn card images it 
has failed to recognize. 
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1 Q Column where host -assigned joh number begins in print banner (HASP and 

JES2): This specifies the starting column of a host system job number in a 
print banner. MR JE/ 3000 expects the host-assigned job number to follow 
the word JOB, TSU, or STC, with one blank character between it and the job 
number, and with at least one non -alphanumeric character following the 
job number: 

rjOB"! 
STC yt^ job numberm 

[tsuJ 

I is a non-alphanumeric (special) character. 

Width of a block letter in the print banner (JES3 and ASP): The block 
character usually is 12 or 13 characters wide. All letters are expected to be 
1 2 characters tall. 

This entry is not used by RSCS. All output is unsolicited. 

1 1 Column where job name begins in a print banner (HASP, JES2, and RSCS): 

This entry specifies the column number in which the job name begins in a 
print banner. MRJE/3000 expects at least one blank following the job 
name. If you enter a zero, MRJE/3000 does not look for a job name. 

This item is not used by JES3 and ASP. 

1 2 Column where host-assigned job number begins in punch banner: This item 
is identical to item 1 except it appears at the beginning of a host punch 
data set. 

This entry is not used by RSCS. All output is unsolicited. 

I 3 Column where job name begins in punch banner: This item is identical to 

Item 1 1 except it appears at the beginning of a host punch data set. A 
non -zero indicates a standard punch code. 

If you enter a zero, MRJE/3000 does not look for a job name and will 
expect the job number to be in special code. These are the special codes and 
the MRJE/3000 interpretation: 

Special Code MRJE/3000 

Hexadecimal: Graphic: Interpretation 



6A 


1 


Blank 


70 







91 


J 


1 


92 


k 


2 


93 


1 


3 


94 


m 


4 


95 


n 


5 


96 


o 


6 


97 


P 


7 


98 


q 


8 


99 


r 


9 
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^'^' This entry is not used by HASP and JES2. MRJE/3000 automatically 

parses a console setup message sent by the host to mount a new form for 
HASP and JES2. The message must be denoted by a string containing 
HAS PI 90 immediately following the console command character identified 
in item 7. The remote number and print or punch number must be the first 
non -blank characters immediately following the first occurrence of one or 
more hyphens, || The FORMID must be the first string immediately 
following the first occurrence of an equal sign, |, and must be delimited by 
blank characters. 

For JES3: The column where a JOB NAME begins in special forms console 
message. MRJE/3000 locates the job name in the forms mount message 
and searches from there to the end for keywords associated with the form 
name and for remote device identification. 

For ASP: The column where JOB appears in special forms console message. 
MRJE/3000 locates the word JOB in the forms mount message and searches 
from there to the end for keywords associated with the form name and for 
remote device identification. 

For RSCS: If the exit procedure MRJECONSOLE/i is in SL. PUB. SYS, then a 
setup message is parsed according to its operation. Appendix E describes 
MRJECONSOLE/z. If an exit procedure is absent, the setup message is 
parsed according to the JES2 use, above, which will fail. 

^ ^' Column where JOB begins in console job received message: When a job is 

submitted to a host system, MRJE/3000 is sent a console message indicating 
the host -assigned job number. This entry specifies the column in which the 
word JOB begins in the message. MRJE/3000 expects the host-assigned job 
number to follow JOB, and for at least one blank to follow the job number- 
JOB hostmrnber" , 

This entry is not used by RSCS. All output is unsolicited. 

^ ^- Column where job name begins in console job received message: This entry 

refers to the same message as entry 1 5, but specifies the column where the 
job name begins. MRJE/3000 expects at least one blank to follow the job 
name. 

This entry is not used by RSCS. All output is unsolicited. 

^ ^ ^^^ "^ESZ and HASP, the column where ON begins in console job received 

message: This entry refers to the same message as items 1 5 and 1 6, but 
specifies the column where the word ii|: begins. MRJE/3000 expects at 
least one blank to follow the word ON . 

This entry is not used by JES3 or ASP. 

This entry is not used by RSCS. All output is unsolicited. 

^ ^- Maximum number of Job Log File entries: A number in the range from 25 

to 1000 that specifies the number of entries the Job Log File can 
accommodate. See the NEW command in Section 4 Managing 
MRJE/3000 . 
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19. Default input device: The logical device number or device class name of the 
device MRJE/3000 uses, by default, to send jobs to the host system. This is 
the spooled pseudo card reader identified in Appendix C, Configuring MPE 
to Include MRJE/3000 in Part 3 -- MRJE/3000 Pseudo Device 
Configuration Dialog. It is commonly Unit 1 7. 

20. Default print output device: The destination logical device number, device 
class name, actual file designator, or FORMID (delimited by single quotes *) 
identifying the file or device for print output. This is used if the user does 
not specify a print or forms output destination in the SUBMIT command. 

This entry is not used by RSCS. All output is unsolicited. 

21. Unsolicited print disposition, printer stream 1: The destination logical 
device number, device class name, actual file designator, or FORMID 
(delimited by single quotes ||) identifying the device or file for print output 
on print stream 1. This is used if MRJE/3000 cannot recognize where 
printer output should be sent. 

22-27. Unsolicited print disposition, printer streams 2-7: Same as entry 21, except 

applies to output on print streams 2-7. 

This entry is not used by RSCS. Only one printer can be configured. 

28. Default punch output device: The destination logical device number, device 
class name, actual file designator, or FORMID (delimited by single quotes ') 
identifying the file or device for punch output. This is used if a punch 
output destination is not present in the SUBMIT command. 

This entry is not used by RSCS. All output is unsolicited. 

29. Unsolicited punch disposition, punch stream 1: The destination logical 
device number, device class name, actual file designator, or FORMID 
(delimited by single quotes |i) identifying the file or device for punch 
output, if MRJE/3000 cannot recognize where punch output should be 
sent. 

30-35. Unsolicited punch disposition, punch streams 2-7: Same as 29, except 

applies to output on punch streams 2-7. 

This entry is not used by RSCS. Only one punch can be configured. 

36. MRJE/3000 output process priority: The output processes, MRJEOUT, of 

MRJE/3000 handle all data sets received from the host. An MRJE/3000 
Manager may declare their collective output priority on the HP 3 000 to be 
in the BS, CS, DS, or ES subqueue. (The MPE System Manager/System 
Supervisor Reference Manual discusses processing priority.) A lower 
priority output processes loads MPE less than a higher one. The ES 
subqueue is recommended. 
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37. Number of characters to test in job name: Whenever MRJE/3000 receives 
a message or an output data set from the host system, it checks the job 
name in the message or data set against the entries in the Job Log File. The 
number of characters to be checked is set in this entry. Since some host 
installations append a job number to the job name, the MRJE/3000 
Manager should be certain that the value entered here does not allow 
MRJE/3000 to read beyond the end of the job name. 

38. Language ID for translation: MRJE/3000 uses the Native Language 
Intrinsics EBCDIC -ASCII translation table for translation of all data sent 
between the remote workstation and the host. Enter the appropriate 
language identification number. A default value of zero I refers to 
NATIVE/ 3 000 as described in the Native Language Support Reference 
Manual. (32414-90001) 



39. Host system telephone number: The number specified is displayed to the 
MPE console operator after an MRJECONTROL START has been issued. If 
the communications line is a permanent connection, or auto -dialing is 
configured on an HP30020B with a telephone number, no number need be 
entered here. 

40. Time communications line opened: If a time is shown, it is the last time 
when the line was opened. An entry does not mean that the line is now 
open. This entry is maintained by MRJE/3000 and cannot be modified. 

41. Time communications line closed: If a communications line was opened and 
subsequently closed, the time of closure is shown in this entry. This entry is 
automatically set by MRJE/3000 1 window 

42. Maximum time job remains active in Job Log after transmittal: The time 
specified (days,hours,minutes) determines an interval after a job is 
transmitted to the host before the job is reclassified as an old job. See the 
PURGE command in Section 4, Managing MRJE/3000. 

43. Host buffer size: The size of the host transmission buffer, in bytes. The 
buffer size is specified by host system personnel. Also see Appendix D, 
Configuring the Host. 
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INSTALLING MRJE/3000 



Modify this MRJE/ 30000 installation procedure to suit your needs. 

1. Obtain an Installation Tape (IT). 

2. Make certain that the necessary hardware has been installed and is operational. Hardware 
includes communications line controllers, INPs or SSLCs, and modems. 

3. Any user exit procedures, those named MRJECONSOLEft, to process console special forms setup 
messages, must be added to the system Segmented Library (SL) at step 5. Follow Appendix C, 
Configuring MPE to Include MRJE/3000 Part 4, beginning at "SYSTEM SL CHANGES?" for 
the procedure. Also see EXIT PROCEDURES, Appendix E. 

Make certain that the communication subsystem (CS) is configured into the system. Add the 
necessary segments to the system SL at step 5. 
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4. Restore these program, data, and pseudo device driver files to group and account PUB. SYS using 

the MPE command RESTORE . 

Program and data files. 



Name: 



Function: 



MRJE User interface. 

MRJEMON Communications Monitor. 

MRJECAT Message Catalog File, a data file. 

MRJEOUT Host output data process. 

MRJELOGR Job logging process. 

Pseudo device driver files. 



Name: 



Pseudo device: 



lOMRJEO First psuedo line. 

I0MRJE1 Second pseudo line. 

lOMCONSO Pseudo console. 

lOMPNLPO Pseudo line printer and pseudo punch. 

lOMRDRO Pseudo reader. 

MRJE/3000 running on an INP requires lOINPO as a driver, and one of these download files: 

• CSDMRJEO for an HP 300 lOA; 

• CSDMRJE1 for an HP 30020A; 

• CSDMRJE2 for an HP 30020B. 

MRJE/3000 running on an SSLC requires CSSBSCO as a driver, and CSSMRJEO as an additional 
and secondary driver. 
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Configure MRJE/3000 into the MPE I/O system using these commands: 

FILE L;DEV=LP 
FILE T;DEV=TAPE 
SYSDUMP *T,*L 

Configure the INP or SSLC with the driver and download file or secondary driver restored in the 
previous step. 

MRJE/3000 pseudo device drivers are: 

• lOMRJEG for the first line monitor, unit 0; 

• I0MRJE1 for the second line monitor, unit 1; 

• lOMCONSO for the pseudo console, unit 2; 

• lOMPNLPO for each pseudo printer, units 3-9, and pseudo punch, units 10 - 16. 

• lOMRDRO for each pseudo reader, units 17 - 23. 

Do not over -configure pseudo peripheral devices. Configure only as many pseudo line printers, 
punches, and readers as you expect to need. A desirable minimum is two pseudo line printers 
and a spooled pseudo reader. Dump the new configuration to tape with all files from the group 
and account PUB. SYS. 

6. Using COLDSTART, load the system using the tape created in Step 5. 

7. Using the UPDATE command, update the tape described in step 1. This completes the installation 
of MRJE/3000. 

8. Issue an MR JECONTROL CHECK command to make certain all the necessary MRJE/3000 
software modules have been correctly installed. 

If an UPDATE has preceded the system, then a useable cold load tape has been created. 

Follow this sequence for trouble-free installation: 
FIRST: BACK UP THE ENTIRE SYSTEM. 

Then: Restore files from an IT, mentioned in Step 1. 

Update the system from the IT, mentioned in Step 1. 

Create a new system tape with a new configuration using SYSDUMP. 
Final ly: Coldstart the system from the tape created. 
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BUILDING MRJE/3000 CONFIGURATION FILES 

Follow these steps to build a separate configuration file for each host system. 

1. Refer to Appendix A, Configuration File Contents, for a description of the contents of the 
MRJE/3000 configuration file. 

2. Use the NEW command to build your configuration files. Before issuing this command, examine 
the list of prompting messages associated with the command in Section 4, Managing 
MRJE/3000. 

3. Log onto the HP3000 as MANAGER . SYS , PUB. 

4. Enter the MRJE command from MPE. 

5. Enter the NEW command and respond to the prompts. 

6. Enter DISPLAY CONFIG and check the configuration. Pay particular attention to items 7-17, 
37, 38, 42 and 43. MRJE/3000 assigns default values for these items. If any of the values is not 
correct for your system, you may change it by using the MRJE/3000 ALTER command. The 
command is described in Section 4, Managing MRJE/3000. 
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BUILDING MRJE/3000 STREAM FILES 

A separate stream file must be built for each host system. The stream file is used whenever an 
MRJECONTROL START command is issued. The stream file must be MRJESTR/?. PUB.SYS where h is the 
first letter of the host identification. It can be created by any user with access to the PUB group of the 
SYS account. The structure of this file is the same as for any stream file. The contents of this stream file 
must execute the monitor proces MRJEMON. PUB. SYS. 

The stream file MRJESTR/i. PUB. SYS must contain the command RUN MRJEMON;INFO="A" as the 
command preceding an EOJ. The stream file can contain other commands, such as SETDUMP. Use 
EDIT/ 3000 or TDP to create this kind of stream file: 

JOB MANAGER. SYS ; HPRI ; RESTART ;TIME=? 

COMMENT 

COMMENT This allows users to route output to 

COMMENT an HP2680 with a specific environment. 

COMMENT 

COMMENT This can be omitted if Output Management 

COMMENT is used. 

COMMENT 

FILE ELITE;DEV=LPS;ENV=ELITE.HPENV.SYS 

FILE HOLDLP;DEV=LPJ 

COMMENT 

COMMENT The stack dump facility is armed to 

COMMENT operate when an MRJEMON problem occurs. 

COMMENT 

SETDUMP DB,ST 

COMMENT 

COMMENT The Message File is $STDLIST. 

COMMENT 

FILE MRJEMSGN=$STDLIST 

RUN MRJEMON; I NFO=" " 

EOJ 

The FILE commands in this stream file can be used by SUBMIT commands. See Global File Specification. 

Access to a stream file, such as the one created in the example above, should be limited to the creator 
through the use of the MPE command ALTSEC. This command is described in the MPE Commands 
Reference Manual (32033-90006). 

BUILDING HOST CONSOLE MESSAGE LOGGING FILES 

If you intend to log the console messages sent by the host, you must build a log file. Build a separate file 
for each host whose messages you want to log. 

Logging file records must contain fixed-length ASCII records at least 80 bytes long. The files must be 
named MRJEMSGfc, where h is the first character of the host ID. For the default host, the name is 
MRJEMSG. The file can be an MSG file, if desired; however, this is not required. Logging files must 
reside in PUB. SYS. Access to host console message logging files should be limited to their creator, 
MANAGER. SYS. Access may be limited through the use of the MPE command ALTSEC. This command 
is described in the MPE V Commands Reference Manual (32033-90006). Refer to Host Console Message 
Logging Facility in Section 4, Managing MRJE/3000, for further information. 
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VERIFYING MRJE/3000 INSTALLATION 

A verification test is included in the MRJE/3000 software. The test activates MRJE/3000 and submits 
two jobs that produce printer, punch, and special form (COOl) output. 

The verification test uses three files: 

• T00T249A 

• T01T249A 

• T02T249A 

T00T249A, when streamed, activates MRJE/3000 and submits the two jobs contained in the files 
T01T249A and T02T249A. Figure B-1 shows the contents of the three files. These files were built for 
submission to a HASP system. They may need to be modified to your host installation. File T00T249A 
was constructed to be streamed by a user with read access to all files in the group and account 
HP30249 . HPPL87. Modify this file to activate the test from another logon group and account. 

1. Configure MRJE/3000 into the MPE system according to the instructions in this 
section and in Appendix C, Configuring MPE to Include MRJE/3000. 

2. Use EDIT/ 3 000 or its equivalent to modify the test file identified above. 



NOTE 



Do not put any sequence numbers on the test files. 
The tests will fail if sequence numbers are present. 



3. Use the NEW command to create the Configuration, Directory and Job Log files. 

4. Use the STREAM command to stream T00T249A. 

5. Issue an MRJECONTROL START command from MPE and make connection with 
the host system. 

The jobs are transmitted, processed by the host; and their output returned through MRJE/3000. If these 
steps do not complete successfully, recheck T00T249A, and T02T249A. If these files appear correct, 
recheck the configuration. 



B-6 



Installing MRJE/3000 on the HP3000 



. T00T249A: 

!JOB T00T249A, FIELD. HPPL87,HP30249;RESTART 

!MRJE 

SUBMIT T01T249A 

D J 

E 

!EOJ 

• T01T249A: 

//MRJEDEM5 JOB ( 1548,HPA) ,SFA,CLASS=X 

//S1 EXEC PGM=IEBGENER 

//SYSPRINT DD SYSOUT=A 

//SYSUTl DD * 

//SYSUT2 DD SYSOUT=A 

//SYSIN DD DUMMY 

##FD T02T249A 

. T02T249A: 

//MRJEDEM2 JOB ( 1548,HPA) ,SFA,CLASS=X 
//FORT EXEC FORTGCLG 
//FORT.SYSPUNCH DD DUMMY 
//FORT. SYSIN DD * 

DO 100 1=1 ,5 

DO 100 J=111111, 1111110, 111111 

K=J-111111 
100 WRITE(6,1000) K,K,K,K,K,K,K,K,K,K,K,K,K,K,K,K,K,K,K,K 

1000 FORMAT (1H ,2016) 
STOP 
END 

//GO.FT06F001 DD SYSOUT=(A, ,0001 ) 
// 



Figure B- 1. MRJE/3000 Verification Jobs 
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CONFIGURING MPE 

TO INCLUDE MRJE/3000 



APPENDIX 



This describes how to configure MRJE/3000 into the MPE I/O system. 

CONFIGURATION REQUIREMENTS 

Each MRJE/3000 communications line to a host must be configured separately into the MPE I/O system; 
each configuration must be compatible with its corresponding host system configuration. 

One communications controller must be configured into the MPE I/O system for each of the MRJE/3000 
communications lines to be operated concurrently. Before configuration can begin, all controllers should 
be installed as described in their respective installation manuals. (See the Preface for a list of manuals.) 
During installation, note the hardware DRT setting for each controller, as the DRT numbers are requested 
during MPE configuration. 

These are the specifications for the devices that are configured into MPE for each MRJE/3000 
communications line. Some devices are required for each line; others are optional. 



Communications Controller 

One communications controller is required. 

SSLC 
Device Type: 1 8 
Unit number: 

Driver: CSSBSCO 
Driver changeable: YES 



Secondary driver. 
Applies to SSLC only: 

Download file. 
Applies to INP only: 



CSSMRJEO 



INP 

17 


lOINPO 
NO 



CSDMRJEO, 

for an HP 3 00 lOA 

CSDMRJEU 
for an HP 3 00 2 OA 
CSDMRJE2, 
for an HP 3 00 2 OB 



Each communications controller can be used by other HP3000 communications subsystems (such as 
AdvanceDS) when it is not being used by MRJE/3000. GuideHnes for configuring multiple data 
communications subsystems appear in Table C- 1. 

Complete details of the configuration process are contained in the System Operation and Resource 
Management Reference Manual (32033-90005). 
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Pseudo Line Monitors 

Two pseudo line monitors are required. They must be configured as Units and 1. 

Device Type: 22 

Device Subtype: 

Unit Number: 

Driver Name: lOMRJEO 

Device Type: 22 

Device Subtype: 

Unit Number: 1 

Driver Name I0MRJE1 

Pseudo Console 

One pseudo console is required. It must be configured as Unit 2. 

Device type: 22 

Device subtype: 

Unit number: 2 

Driver: lOMCONSO 
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Pseudo Line Printers 

up to seven pseudo line printers can be configured as Units 3-9. One pseudo line printer is required, 
starting with Unit 3. Do not skip Unit numbers. The combination of pseudo line printers and punches 
must not exceed 8. 

Although MRJE/3000 provides for up to seven pseudo printers and seven pseudo punches, the number 
that can be configured is limited to the number of printers and punches configured on the host. 
Furthermore, configuring a large number of printers and/or punches causes more overhead for the 
HP 3 000 system. 

Configure only as many printers and punches as you need. Two pseudo printers are a desirable minimum. 

Device type: 22 



Device subtype: 





Unit numbers: 


3-9 


Driver: 


lOMPNLPO 
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Pseudo Card Punches 

up to seven pseudo card punches can be configured as Units 10 - 16. No pseudo card punches are 
required. Do not skip Unit numbers. The combination of pseudo line printers and punches must not 
exceed 8. 

Although MRJE/3000 provides for up to seven pseudo printers and seven pseudo punches, the number 
that can actually be configured is limited to the number of printers and punches configured on the host. 
Furthermore, configuring a large number of printers and/or punches causes more overhead for the 
HP3000 system. 

Configure only as many printers and punches as you need. 

Device type: 22 

Device subtype: 

Unit numbers: 10 - 16 

Driver: lOMPNLPO 



Pseudo Card Readers 

up to seven pseudo card readers can be configured as Units 17 - 23. One pseudo card reader is required, 
starting with Unit 17. Do not skip Unit numbers. Only one pseudo card reader should be initially 
spooled. Another pseudo card reader can be configured as unspooled, and used as a hot reader. 

Device type: 22 

Device subtype: 

Unit numbers: 17-23 

Driver: lOMRDRO 



Additional Drivers 

One additional driver is required when an SSLC is configured as the communications controller. Its name 
is CSSMRJEO. It is configured without a logical device number or DRT number. 
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Download Files 

Download files are required for an INP. 

Download file for HP30010A: CSDMRJEO 

Download file for HP30020A: CSDMRJEl 

Download file for HP30020B: CSDMRJEl 



General Pseudo Device Information 

MRJE/3000 pseudo devices are not physical devices. They do not have hardware DRT numbers. When 
prompted for their DRT number during the configuration dialog, respond with a pound sign (#) followed 
by the Idev number of the controller for this line. 

The pound sign convention is illustrated in Figure C-1: 

• SSLC1 is configured with logical device number 13; 

• The associated pseudo devices have all been configured with DRT numbers of # 1 3. 

If more than one communications controller is to be configured for use by MRJE/3000, each controller 
must have a unique logical device number and its associated pseudo devices must have that number as 
their DRT number. 
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LOG DRT U 


C 


T 


DEV # N 


H 


Y 


# I 


A 


P 


T 


N 


E 



SUB TERM REG OUTPUT 

TYPE TYPE SPEED WIDTH DEV 



MODE DRIVER DEVIGE 
NAME CLASSES 



1 


4 











6 




128 







*I0MDISC1 


SPOOL 






















DISC 


2 5 


1 








8 




128 







*I0MDISC1 


SPOOL 
DISC 


5 13 








8 







40 


LP 


JA 


lOGDCDO 


CARD 


6 14 








32 


2 




66 







S lOLPRTO 


LP 


7 6 








24 







128 







lOTAPEO 


TAPE 


8 6 


1 





24 







128 







lOTAPEO 


TAPE 


1 13 18 


2 





24 







40 


LP 


JA 


lOTAPEO 


JOBTAPE 








17 















lOINPO 


INPl 


20\ 7 








16 





10 ? 


? 40 


20 


JAID 


lOTERMO 


TERM 


21 \ 7 


1 





16 





10 ?? 40 


21 


JAID 


lOTERMO 


TERM 


22 


^ 7 


2 








16 
22 






10 ? 


? 40 
40 


22 




JAID 


lOTERMO 
lOMRJEO 


TERM 


40 


#13 


MRJEl 


41 


#13 


1 





22 







40 







lOMRJEl 


MRJE2 


42 


#13 


2 





22 







67 







lOMCONSO 


MGONS 


43 


#13 


3 





22 







67 







lOMPNLPO 


MLPl 


44 


#13 


4 





22 







67 







lOMPNLPO 


MLP2 


45 


#13 


5 





22 







67 







lOMPNLPO 


MLP3 


46 


#13 


6 





22 







67 







lOMPNLPO 


MLP4 


47 


#13 


7 





22 







67 







lOMPNLPO 


MLP5 


48 


#13 


8 





22 







67 







lOMPNLPO 


MLP6 


49 


#13 


9 





22 







67 







lOMPNLPO 


MLP7 


50 


#13 


10 





22 







40 







lOMPNLPO 


MPNGHl 


51 


#13 


11 





22 







40 







lOMPNLPO 


MPNGH2 


52 


#13 


12 





22 







40 







lOMPNLPO 


MPNGH3 


53 


#13 


13 





22 







40 







lOMPNLPO 


MPNGH4 


54 


#13 


14 





22 







40 







lOMPNLPO 


MPNCH5 


55 


#13 


15 





22 







40 







lOMPNLPO 


MPNCH6 


56 


#13 


16 





22 







40 







lOMPNLPO 


MPNGH7 


57 


#13 


17 





22 







40 







S lOMRDRO 


MRDRl 


58 


#13 


18 





22 







40 







lOMRDRO 


MRDR2 


59 


#13 


19 





22 







40 







lOMRDRO 


MRDR3 


60 


#13 


20 





22 







40 







lOMRDRO 


MRDR4 


61 


#13 


21 





22 







40 







lOMRDRO 


MRDR5 


62 


#13 


22 





22 







40 







lOMRDRO 


MRDR6 


63 


#13 


23 





22 







40 







lOMRDRO 


MRDR7 



LDN PM PRT LCL TC RCV LCL CON MODE 

MOD TMOUT TMOUT TMOUT 

13 1 1 1 20 60 900 OIA 



TRANSMIT TM BUFFER D DRIVER 

SPEED SIZE C OPTIONS 

600 1 1024 Y 



LDN CTRL 
LEN 
13 



PHONE NUMBER LIST 



LOCAL ID SEQUENCE 

REMOTE ID SEQUENCE 



ADDITIONAL CS DRIVERS 



047038-04 



Figure C- 1 . MRJE/3000 Configured into MPE. 

The communications interface is an INF. Configure only as many pseudo printers, punches, and readers as 
you actually need; these pseudo devices consume system resources. 
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THE CONFIGURATION DIALOG 

This configuration dialog includes only those steps that pertain to MRJE/3000. If the communication 
controllers are to be used by multiple communications subsystems, refer also to Table C-1, SSLC and INP 
Configuration Summary. 

The configuration dialog below is divided into four parts. 

• Parts 1 and 4, both named Dialog Common to All Devices, apply whether an SSLC, an INP, or an 
MRJE/3000 pseudo device is being configured; the dialog is common to all three. 

• Part 2 describes the portion of the dialog that applies only to the SSLC and INP; 

• Part 3 describes the dialog that applies only to MRJE/3000 pseudo devices. 

Whenever indicated in the dialog, press the (RETURN) key in response to the prompting message. User 
responses are highlighted to distinguish them from HP3000 prompts. You can substitute | or | for 
III or II responses. 

Follow the steps in Installing MRJE/3000. Then, to begin the configuration process, log onto the system, 
define the output device files, and initiate a SYSDUMP: 

:HEL10 MANAGEf?.SYS 

HP3000 / MPE IV C.A1.A2. (EREHWON) FRI , JUN 15, 1984 8:57 AM 



:fIL£ T;DEV=TAPE 
rflLE L;DEV>=LP 
:SYSOUMP *T,*L 



NOTE 



The file equations used with SYSDUMP command from MPE must reflect 
the tape and Hne printer device class names actually configured on the 
HP 3 000 system. They might not be configured as TAPE and LP on your 
system. 
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step 
No. 

1 

2 



Dialog 



ANY CHANGES? YES 



SYSTEM ID = HP 32002 . . uu . ff? [RETURN) 

A version letter, v, and update and fix numbers, uu. ff are printed. 

MEMORY SIZE = xxx.? [RETURN] 

I/O CONFIGURATION CHANGES? YES 

LIST I/O DEVICES? YES 

All I/O devices currently configured on the system are listed with these column headings: 



LOG DEV 
DRT # 
UNIT # 
CHAN 
TYPE 



SUBTYPE 

TERM TYPE 
REC WIDTH 
OUTPUT DEV 
MODE 



DRIVER NAME 
DEVICE CLASSES 



Logical device number 

Hardware device address 

Number of the device on its controller 

Always for MRJE/3000 devices 

Device type: 

Always 1 7 for INP 

Always 1 8 for SSLC 

Always 22 for MRJE/3000 pseudo devices 

Device subtype. 

Always for MRJE/3000 pseudo devices 

Terminal type 

Record width, decimal words 

Device class name or device number 

J = Accept jobs 

A = Accept data 

I = Interactive device 

D = Duplicative device 

S = Spooled device 

Driver name 

Class names assigned 
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LIST CS DEVICES? YES 



This prompt appears only if a communications device is currently configured in the system. 
The list is printed with the following column headings: 



LDN 


Logical device number 


PM 


Port mask. Always for MRJE/3000 devices 


PRT 


Protocol 


LCL MOD 


Local mode 


TC 


Transmission code 


RCV TMOUT 


Receive timeout 


LCL TMOUT 


Local timeout 


CON TMOUT 


Connect timeout 


MODE 


= Dial out 




I = Manual answer 




A = Automatic answer 




D = Dual speed 




H = Half speed 




C = Speed changeable 


TRANSMIT SPEED 


Transmission speed in characters per second 


TM 


Transmission mode 


BUFFER SIZE 


Default buffer capacity in words 


DC 


Driver changeable, or not changeable 


DRIVER OPTIONS 


Driver options 



If the MPE system currently has a switched device, a dial-up telephone line, then additional 
information is printed in the following columns: 

LDN 

CTRL LEN 

PHONE NUMBER LIST 

LOCAL ID SEQUENCE 

REMOTE ID SEQUENCE 



HIGHEST DRT = xx.? return or nn > mor (RETURN] 



XX denotes the current highest hardware device number that can be assigned. Enter [RETURN] 
if the number displayed is large enough to include the devices that are being added. 
Otherwise, enter a higher DRT number. 

If an SSLC or INP is being configured, continue on to Part 2 -- SSLC and INP Dialog. If configuring a 
pseudo device, proceed to Part 3 -- MRJE/3000 Pseudo Device Configuration Dialog. 
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Use this part for configuring an INP or an SSLC. 

Step Dialog 

No. 



8 LOGICAL DEVICE #? |||! 

Enter a unique number within the range 1 to maximum allowed by MPE. All devices are 
recognized by this number. This prompt is repeated later in the dialog to allow for 
configuration of more than one SSLC or INP. 



9 DRT #? nil 

Enter the hardware DRT number of the INP or SSLC. Enter | to cancel response to the 
previous prompt. 

10 UNIT #? I 

An INP or SSLC should always be assigned unit number on its controller. 

11 SOFTWARE CHANNEL #? | 

MRJE/3000 pseudo devices do not use software channels. 

12 TYPE? 1 T Always 1 7 for the INP. 

18 Always 18 for the SSLC. 

13 SUBTYPE? I or I 



Reply I for a synchronous switched line with modem, telephone dial network. A subtype of 
zero enables Data Terminal Ready (DTR). 

Reply I for a synchronous non -switched line with modem, leased line. 

If an INP is being configured, the dialog skips to step 20. 

17 PROTOCOL? r\nr\ 

Enter an integer 1 to 255. MRJE/3000 does not use your response. 

18 LOCAL MODE? || 

Enter an integer 1 to 1 5. MRJE/3000 does not use your response. 

19 TRANSMISSION CODE? m 

Enter an integer 1 to 63. MRJE/3000 does not use your response. 

20 RECEIVE TIMEOUT? [RETURN] 
MRJE/3000 ignores your response. 
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21 LOCAL TIMEOUT? (RETURN) 

MRJE/3000 ignores your response. 



22 CONNECT TIMEOUT? (RETURN) 

MRJE/3000 ignores response. 

If the INP or SSLC was configured as subtype in Step 1 3, because it is connected to a switched telephone 
line, the dialog continues with the next prompt. If the SSLC or INP was configured as subtype 1 in Step 
1 3, because it is connected with a non -switched leased line, the dialog skips to Step 29 



23 DIAL FACILITY? (RETURN) or mm, where nnn is an Idev. 

Enter Idev to show an HP 30020B, connecting to a Bell 80 IC auto-dialing unit with a 
special auto-diahng cable (HP 3 02 2 IG). If this device is installed, then calls are dialed 
automatically. 



NOTE 



The Idev, the same value as entered in Step 8, must be entered 
here to indicate that automatic dialing of calls may occur. 
This feature is supported for an INP 30020B connected to a 
Bell 801C Automatic Calling unit with an HP 3022 IG cable. 



24 ANSWER FACILITY? YES or fRETURNl 

Reply YES if Idev is specified in Step 23 and an HP 30020B is configured, and is used for 
auto-dialing. Otherwise, reply (RETURN) . 

25 AUTOMATIC ANSWER? YES or (RETURN) 

Reply YES if Idev is specified in Step 23 and an HP 30020B is configured, and is be used for 
auto-diahng. Otherwise, reply (RETURN) . 

26 DUAL SPEED? MM Local modem is dual speed; European models only. 

|i|i Local modem is single speed. 

After a ii response to Step 26, the dialog skips the next step. 

27 HALF SPEED? For European models only. 

YES Modem operates at half speed. 
NO Modem operates at full speed. 

After a response to this prompt, the dialog skips the next step. 
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28 SPEED CHANGEABLE? YES or || 

This is ignored for modems that provide internal clocking signals. 

29 TRANSMISSION SPEED? nnnnn 

Enter the line transmission speed in characters per second: 



Characters per 


Second 


Bi 


LtS 


per second 


2S0 










2000 


300 










2400 


mo 










4800 


900 










7200 


1200 










9600 


TOOO 










56000 



Specified transmission speed is ignored for modems with internal clocking signals. So, 
modems of different speeds may be used without reconfiguring MPE. You must use a 
30221D (39221-60010) cable at 56000 bits per second. 

30 TRANSMISSION MODE? I or | 

I Full Duplex. 
Half Duplex. 



Configure the INP or SSLC to operate in Full Duplex (|) mode if communications take place 
over one of the following: 

• A leased four-wire point-to-point line. 

• A dial network with two lines (four-wire). 

• A dial network with Wide Band Service. 

Configure the INP or SSLC to operate in Half Duplex (1) if communications are over a dial 
network with a single-line (two-wire). 



31 PREFERRED BUFFER SIZE? |||i MRJE/ 3 000 ignores the response. 

32 DRIVER CHANGEABLE? YES SSLC only. 

NO INP only. 

33 DRIVER OPTIONS? I 
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34 DRIVER NAME? illili for an INP 

iiilllii for an SSLC 



NOTE 



For auto-dial support on an HP30020B, the download file is 
CSDBSC2. 



Steps 44 through 47 apply to SSLCs or INPs that use a synchronous switched telephone line. These are 
type 17, subtype for INP; type 18, subtype f or SSLC. For SSLCs or INPs configured as subtype 1, 
synchronous non -switched leased line, the dialog skips to Step 48. 



44 PHONELIST? (RETURN) . ||i or || 

A ill causes the next step to be executed. A |ii causes step 4 8 to be executed. 

45 PHONE NUMBER? nnnnnninnnninfininnnnninn 

A string of numbers and hyphens not to exceed 3 characters. 



NOTE 



MRJE/3000 Configuration Files allow 16 characters. 

46 LOCAL ID SEQUENCE? (RETURN) MRJE/3000 ignores the response. 

47 REMOTE ID SEQUENCE? (RETURN) MRJE/3000 ignores the response. 

48 DEVICE CLASSES? (RETURNl MRJE/3000 ignores the response. 

The dialog returns to Step 8 to allow configuration of another SSLC or INP or configuration of the pseudo 
devices. If all devices have been defined, press (RETURN) in response to the LOGICAL DEVICES? prompt 
and proceed to Part 4 -- Dialog Common to All Devices. 
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PART 3 ~ MRJE/3000 PSEUDO DEVICE CONFIGURATION 

Use this as a guide to configure MRJE/3000 pseudo devices. 
Step No. Dialog 

8 LOGICAL DEVICE #? ■! 

Enter a unique number within the range 1 to maximum allowed by MPE. All devices are 
recognized by this number. This prompt is repeated later in the dialog to allow for 
configuration of more than one INP or SSLC. 

9 DRT #? §nr\n 

Enter a pound symbol (#) followed by a number identical to the logical device number of the 
INP or SSLC for which this pseudo device is being configured. 

Refer to CONFIGURATION REQUIREMENTS at the beginning of this appendix. 

10 UNIT#?|-|| 

Pseudo device Unit numbers must be assigned this way: 
UNIT NUMBER DRIVER NAME PSEUDO DEVICE 






1 


lOMRJEO 


First line monitor. 


1 


1 


I0MRJE1 


Second line monitor. 


2. 


1 


lOMCONSO 


Pseudo console. 


3 


1 


lOMPNLPO 


First pseudo printer. 


4 - 


9 ' 


lOMPNLPO 


Other pseudo printers 


10 


- 16 ' 


lOMPNLPO 


Pseudo punches. 


17 


1 


lOMRDRO 


First pseudo reader. 


18 


- 23 ' 


lOMRDRO 


Other pseudo readers 



* = This device is required. 

' = Use Unit numbers in ascending order, lowest first. 

11 SOFTWARE CHANNEL #? | 

Pseudo devices do not use software channels. 

12 TYPE? m 



NOTE 



All pseudo devices are type 22. 
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Part 3 -- MRJE/3000 Pseudo Device Configuration 
1 3 SUBTYPE? I 



NOTE 



All MRJE/3000 pseudo devices are subtype 0. 



34 RECORD WIDTH? nnn in words. 

40 Pseudo line monitor, card reader, and card punch. 

67 Pseudo console. 

6? - 121 Pseudo line printer. 



NOTE 



A maximum record width of 25 5 bytes is supported for pseudo 
line printers. 



35 OUTPUT DEVICE? M 

36 ACCEPT JOBS/SESSIONS? M 

37 ACCEPT DATA? |i 

38 INTERACTIVE? H 

39 DUPLICATIVE? || 

41 INITIALLY SPOOLED? ||i or |i 

Spool the first pseudo card reader, Unit 1 7, as an output device. All other pseudo devices 
should not be spooled. 

Although the pseudo line printers should never be spooled, at least one actual MPE line 
printer should be spooled to handle MRJE/3000 output. The spooled printer should be 
specified as the default output device in entry number 20 of the MRJE/3000 configuration 
file that corresponds to this configuration. 
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Part 3 — MRJE/3000 Pseudo Device Configuration 



42 



INPUT OR OUTPUT? OUTPUT 

This question is asked if the response to the preceding prompt was Y£S. 



NOTE 



The pseudo card reader is configured as an MPE spooled output 
device, because it is used to send data from an HP 3 000 to 
another system. It should be specified as the default input 
device in entry number 19 of the MRJE/3000 Configuration 
File, because it is used for input to the host system. 



43 



DRIVER NAME? 



See the Unit Number in Step 1 0, above. 
lOMRJEO First pseudo line monitor, Unit 0. 
I0MRJE1 Second pseudo line monitor. Unit 1. 
lOMCOMSO Pseudo console, Unit 2. 
lOMPMLPO Pseudo line printers and card punches, 

Units 4-16. 
lOMRORO Pseudo card readers. Units 18-23. 



48 



DEVICE CLASSES? [RETURN] or name 

(^RETURN) Line monitor, pseudo console, pseudo printers, pseudo punches: 

MRJE/3000 does not use names for these pseudo devices. Names may be 
provided for documentation within MPE. If names are used, they must 
be unique. 

nameor Pseudo card readers: A uniq ue name of up to eight alphanumeric 
(RETURN) characters in length, or [RETURN) . 

name SPOOLED pseudo card reader: The default class name of an MRJE/3000 
spooled pseudo reader is MRDR1 . If another name is entered here, modify 
item 19 of the MRJE/3000 Configuration File with an ALTER 
command. 

The dialog now returns to Step 8 to allow configuration of additional devices. If all I/O devices have 
been configured, press the RETURN key in response to the LOGICAL DEVICE#? prompt and continue 
with Part 4 -- Dialog Common to All Devices. 
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PART 4 ~ DIALOG COMMON TO ALL DEVICES 

Use this part when configuring all devices. 

Step Dialog 
No. 

51 MAX # OF OPEN SPOOLFILES = xx . ? (RETURN! 

52 LIST I/O DEVICES? YtS 

53 LIST OS DEVICES? VES 



54 CLASS CHANGES? (RETURN) 
66 LIST I/O DEVICES? (RETURN) 

The prompt for Step 67 is issued only if a communications device is currently configured in 
the system, or if additional drivers exist. 



67 ADDITIONAL DRIVER CHANGES? NO f or an INP, ||| f or an SSLC. 

68 LIST ADDITIONAL DRIVERS? (RETURN) 

69 DELETE DRIVERS? (RETURN) 

71 ADD DRIVERS? YES for an SSLC only. 

72 DRIVER NAME? CSSMRJEO for SSLC only. 

72 DRIVER NAME? (RETURN) 

73 LIST ADDITIONAL DRIVERS? ||| 

4 I/O CONFIGURATION CHANGES? (RETURN) 

74 SYSTEM TABLE CHANGES? (RETURN) 

You may need lOQ and ICS entries. If necessary, contact your Hewlett-Packard 
representative for assistance. 

92 MISC CONFIGURATION CHANGES? (RETURN) 

108 LOGGING CHANGES? (RETURN) 

115 DISC ALLOCATION CHANGES? (RETURN) 

129 SCHEDULING CHANGES? (RETURN) 

130 SEGMENT LIMIT CHANGES? (RETURN) 



137 SYSTEM PROGRAM CHANGES? (RETURN) 
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Part 4 — Dialog Common to All Devices 

139 SYSTEM SL CHANGES? Ilj or (REtDrnI 

Answer YES if: 

• This is the first communications controller to be configured into the system; 

• A user exit procedure, MRJECONSOLE/i, is to be configured into the system. EXIT 
PROCEDURE, Appendix E, describes user exit procedures to process special forms setup 
messages. 

Answer W§ if: 

• The system already has its INPs or SSLCS configured. 

• User exit procedures, MRJECONSOLE/i, do not require configuration. 

140 LIST LIBRARY? |i 

141 DELETE SEGMENT? B 
143 REPLACE SEGMENT? p 

145 ADD SEGMENT? M 

146 ENTER SEGMENT NAME, USLFILE NAME [,S/C/P]? 

?COMSYS1,U0Oy251A.HP302S1.HPPL87,S 

?COMSYS2,U0Oy251A.HP30251.HPPL87,S 

?COMSYS3,U0OU251A.HP302S1.HPPL87,S 

?COMSYS4,yOOU2S1A.HP30251.HPPL87,S 

?COHSYS5,y0Oy2S1A»HP3025t.HPPL87,S 

?CSUTILTY,U01U251A.HP30251.HPPL67,S 

?BSCLCM,U03U251A.HP30251.HPPL87,S 

?BSCSLCPC,U04U251A.HP30251.HPPL87,S 

?DVRSSLC,U051I251A.HP30251.HPPL87,S 

WRJESEG.MRJEUSL.PUB.SYS <<See NOTE following. >> 

? (RETURNl 



NOTE 



Both MRJESEG and MRJEUSL.FVB^SYS are put here to remind 
you that any user exit procedures, MRJECONSOLE/i in 
Appendix E, are configured in this step. 



148 ENTER DUMP DATE? I, (RETURN) , or mrnmm^ 



I Copies the entire system: MPE, the current accounting structure, 
and all files. This is appropriate with files @. PUB. SYS, as 
indicated in Step 149. 
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Part 4 -- Dialog Common to All Devices 



(RETURN) Copies the modified MPE: When this copy is used to 
COLDSTART the system, the accounting structure and all files 
remain intact. 

mmfdd/^y Where tm/dd/ifif is a date in the future: Copies the modified 
MPE and the current accounting, but no files. 

tm/dd/yy Where imn/dd/yy is usually the date of the most recent system 
backup: Copies the modified MPE, the current accounting 
structure, and any files that were changed on or since the 
specified date. 



149 



ENTER DUMP FILE SUBSETS? (RETURN) , or fit^Si^t list. 

(RETURN) is the equivalent of %,%,%. You can also enter a file name, a series of file names, or 
a/iie^enike^.PUB,SYS. 



150 
151 



LIST FILES DUMPED? M 

The HP 3 000 system operator now issues a ||i|| console command to assign a destination 
storage device for SYS DUMP output. 



After the SYSDUMP is complete, the tape produced should be used to COLDSTART the system. During a 
COLDSTART, the old I/O device configuration is replaced with the new one from the SYSDUMP tape. 
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CONFIGURING AN INP OR SSLC FOR SEVERAL SUBSYSTEMS 

If several subsystems use an INP or SSLC, it must be configured to be compatible for all. Table C-1 
summarizes the configuration choices available for each subsystem when it is the sole user of an INP or 
SSLC. Select the choices that permit your set of subsystems to use an INP or SSLC. 

Table C-1. INP and SSLC Configuration Summary 
Step MPE Prompt and the Recommended Response 

No. for Each Data Communications Subsystem 

10 UNIT #? I 

11 SOFTWARfE CHANNEL #? | 

12 TYPE? 17 for an INP. 

18 for an SSLC. 



13 SUBTYPE? i, I, I, I 

Subtype values allowed are: 

• = Synchronous, switched line with a modem; 

• 1 = Synchronous, non -switched line with a modem; 

• 3 = Synchronous hardwired line; 

• 7 = Asynchronous hardwired line; 

Specify subtype for subsystems as follows: 

• or 1 for AdvanceDS, RJE/3000, MRJE/3000; 

• 0, 1, 3 or 7 for MTS; 

• 1 for IMF/ 3 000. 

17 PROTOCOL? I 
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Table C-1. INP and SSLC Configuration Summary (continued) 



18 LOCAL MODE? | or |. 

The values for local mode are: 

• 1 = Local is multipoint control station or primary contention station. 

• 2 = Local is secondary contention station. 
Set local mode as follows: 

• 1 or 2 for AdvanceDS, or RJE/3000; 

• 1 for MTS and IMF/ 3 000. 



NOTE 



MRJE/3000 overrides this setting. 

19 TRANSMISSION CODE? |, |, or | 

Values allowed are: 

• 1 = Automatic code sensing; 

• 2 = ASCII; 

• 3 = EBCDIC. 

Specify 1, 2, or 3 for AdvanceDS or RJE/3000. 



NOTE 



MRJE/3000, MTS, and IMF/3000 override the response. 



C-21 



Table C-1. INP and SSLC Configuration Summary (continued) 

20 RECEIVE TIMEOUT? - 32000 seconds, or [RETURN) 

The default value is 20 seconds. 
Use - 32000, or [RETURNl for AdvanceDS, RJE/3000, MTS, and IMF/3000. 



NOTE 



MR JE/ 3000 overrides your response. 

21 LOCAL TIMEOUT? | - 32000 seconds, or (returnI . 

The default is 60 seconds. 
Use - 32000, or [RETURN! for AdvanceDS, RJE/3000, MTS, and IMF/3000. 



NOTE 



MRJE/3000 overrides your response. 

22 CONNECT TIMEOUT? 

The default is 900 seconds. 
Recommended values are: 

• III for AdvanceDS, RJE/3000, and MTS. 

• Hi + for IMF/3000. 



NOTE 



MRJE/3000 overrides your response. 
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Table C-1. INP and SSLC Configuration Summary (continued) 

23 DIAL FACILITY? |||, M^ |||| where n«n is an Wev, or 

[RETURN] , 

AdvanceDS, RJE/3000, and MTS use your response. 

MRJE/3000 with auto-dial uses the Idev response. 

MRJE/3000 without auto-dial, and IMF/ 3000 do not use response. 



NOTE 



The Idev, the same value as entered in Step 8, must be entered 
here to indicate that automatic dialing of calls may occur. 
This feature is supported for an INP 30020B connected to a 
Bell 80 IC Automatic Calling unit, with an HP 3022 IG cable. 



24 ANSWER FACILITY? YES, or (MTDrnI 

AdvanceDS, RJE/3000, and MTS use response. MRJE/30aO uses this if an Idev is used in 
Step 23, and only when an auto -dialer is connected to an HP 3 00 2 OB INP with an HP 
3022 IG cable. 

IMF/ 3 000 does not use response. 

25 AUTOMATIC ANSWER? YES or [RETURNl 

Reply YES if an Idev is specified in Step 23, and an HP 30020B is configured, and is used for 
auto -dialing; otherwise, reply (RETURN) . 

26 DUAL SPEED? YES or NO 

YES or NO for AdvanceDS, RJE/3000, MRJE/3000. 

YES for European modems, only. 

NO for MTS. 

IMF/ 3 000 doesn't use your response. 



27 HALF-SPEED? ||| or M 

AdvanceDS, RJE/3000, MRJE/3000 use your response. 
MTS AND IMF/ 3 000 do not use your response. 

28 SPEED CHANGEABLE? YES or ■ 

Your response is overridden for modems with internal clocking. 
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Table C- 1. INP and SSLC Configuration Summary' (continued) 

29 TRANSMISSION SPEED? 250, 300, 600, 900, 1200, 7000. 

Enter the line transmission speed in characters per second. 
IMF/ 3 000 overrides your response. 



NOTE 



You must use a DDS Modem and a 30221D (30221-60010) 
cable with a V. 35 hood at a speed of 7000 characters per 
second. 



30 TRANSMISSION MODE? 



i Full duplex 

t 



Half duplex 

31 PREFERRED BUFFER SIZE? - 4095 words 

Recommended values are: 

• A 1024 word maximum for an INP. 

• A 4095 word maximum for an SSLC. 

• Use 1024 recommended for AdvanceDS. 

• Use 500 recommended for MTS. 



NOTE 



MRJE/3000, RJE/3000 and IMF/3000 override your 
response. 



32 DRIVER CHANGEABLE? 

Use YES MRJE/3000, and MTS with SSLC only. Use B for all other subsystems and 
configurations. 

33 DRIVER OPTIONS? 

43 DRIVER NAME? lOIMPO f or an INP, ||||||| for an SSLC 
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Table C-1. INP and SSLC Configuration Summary (continued) 



44 PHONE LIST? ||| or Hi 

AdvanceDS, RJE/3000, and MTS use your response. MRJE/3000 without auto-dialing and 
IMF/ 3 000 override your response. 

A phone list is used only for auto-dialing and when connected to an HP 30O20B INP. The 
telephone number in item 39 of a MRJE/3000 configuration file (MRJECONft) always 
over-rides the phone list. When auto-diahng is specified for an HP 30020B, and when there 
is no telephone number in item 39 of the configuration file, the phone list is used. In all 
other situations the phone list is used for MRJE/3000. 

MRJE/3000 reads only the first number in the phone list. This is the MRJE/3000 default 
number. 

An HP 30020B must be connected with a Bell 80 IC auto-dialing unit using a special HP 
3 022 IG cable. 



A i^ii response causes the next step to be skipped. 



46 LOCAL ID SEQUENCE? 14 character string or (RETURN) 

AdvanceDS uses your response. MTS, RJE/3000, MRJE/30aO, and IMF/3000 do not use 
your response. 



47 REMOTE ID SEQUENCE? id character string or [return! 

AdvanceDS uses response. MTS, RJE/3000, MRJE/3000, and IMF/3000 do not use response. 

48 DEVICE CLASSES? 

claissnaiHe or [return) for AdvanceDS, MRJE/3000, MTS, and IMF/3000. 

RJLINE for RJE/3000. Additional names are optional; see RJE/3000 Reference Manual 
(30000-90047), for a discussion of the RJLINE subsystem command. 



CAUTION 



Do not use the same class name for both an INP and an SSLC. 



67 ADDITIONAL DRIVER CHANGES? 

YES forMRJE/3000 and MTS with SSLC only. 
NO for all other subsystems and configurations. 

71 ADD DRIVERS? YES or NO 

72 DRIVER NAME? CSSMRJEO for MRJE/3000 with an SSLC, llliiH for MTS with an SSLC. 



C-25 



LOG DRT U 

DEV # N 

# I 

T 



C T 

H Y 

A P 

N E 



SUB TERM REC OUTPUT 
TYPE TYPE SPEED WIDTH DEV 



MODE DRIVER DEVICE 
NAME CLASSES 



1 



6 



10 8 



13 
14 
6 
6 
6 
18 
7 
7 
7 
#13 
#13 
#13 
#13 
44 #13 

50 #13 

51 #13 

57 #13 

58 #13 



5 

6 

7 

8 

9 

13 

20 

21 

22 

40 

41 

42 

43 



10 

11 

17 

18 



8 
32 2 
24 
24 
24 
17 
16 
16 
16 
22 
22 
22 
22 
22 
22 
22 
22 
22 



10 ?? 
10 ?? 
10 ?? 



128 

128 

40 

66 

128 

128 

40 



40 

40 

40 

40 

40 

67 

67 

67 

40 

40 

40 

40 



LP 



LP 








> 



20 

21 

22 





















JA 



JA 

JAID 
JAID 
JAID 



*I0MDISC1 

*I0MDISC1 

lOCDCDO 
S lOLPRTO 
lOTAPEO 
lOTAPEO 
lOTAPEO 
lOINPO 
lOTERMO 
lOTERMO 
lOTERMO 
lOMRJEO 
I0MRJE1 
lOMCONSO 
lOMPNLPO 
lOMPNLPO 
lOMPNLPO 
lOMPNLPO 
S lOMRDRO 
lOMRDRO 



SPOOL 

DISC 

SPOOL 

DISC 

CARD 

LP 

TAPE 

TAPE 

JOBTAPE 

INP1 

TERM 

TERM 

TERM 

MRJE1 

MRJE2 

MCONS 

MLP1 

MLP2 

MPNCH1 

MPNCH2 

MRDR1 

MRDR2 



LDN PM PRT LCL TC RCV LCL CON MODE 

MOD TMOUT TMOUT TMOUT 
13 1 1 1 20 60 900 OIA 



TRANSMIT 

SPEED 
600 



TM BUFFER D DRIVER 
SIZE C OPTIONS 
1 1024 Y 



LDN CTRL 
LEN 
13 



PHONE NUMBER LIST 



LOCAL ID SEQUENCE 

REMOTE ID SEQUENCE 



ADDITIONAL CS DRIVERS 



NOTE 



This configuration has two printers, two punches, and two readers. More 
could be configured. 
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APPENDIX 




Follow these guidelines when configuring the host system for communication with MRJE/3000. 

CONFIGURING A JES2 SYSTEM 

For a JES2 system, specify: 

• Remote terminal type: S/360. 

• The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 

• For each remote printer configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started printer. 

c. No FCB support. 

d. Separator pages. 

e. Printer width: 255 characters or less. 

• For each remote card punch configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started punch. 

c. Separator cards. 

• For each remote card reader configured at a remote terminal: Automatically started {hot) card reader. 

• A standard forms name of STD. in the standard forms parameter or use STD. as the name of standard 
forms for both printers and punches. 



NOTE 



If Output Management, MRJETABL, is being used, specify an entry with 
STD. as a FORM ID. 



Communication line: 

a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for communication through an SSLC. Less than or 
equal to 56000 bits per second for communication through an INP. 

c. EBCDIC and transparent. 



D-1 



Configuring the Host 

• Multileaving buffer size: Not to exceed 2000 characters. A large buffer size improves performance 
when the communication line operates at 56Kb. 

• All other generation parameters should be specified consistent with practices at the host site. 

Make note of the value being configured for the number of print lines per page. This value should be 
used as item number 8 in the MRJE/3000 configuration file for this host. 



NOTE 



Consult with host system operations when your communications line is 
configured at 56Kb. Also, configure two printer streams for better 
subsystem performance at this speed. 



CONFIGURING A JES3 OR ASP SYSTEM 

For a JES3 or ASP system, specify the following: 

• Remote terminal type: S/360 

• The terminal should have: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 

• For each remote printer configured at a remote terminal: 

a. Automatically started printer. 

b. No FCB support. 

c. Printer width of 255 characters or less. 

d. Separator pages. 

• For each remote card punch configured at a remote terminal: 

a. Automatically started punch. 

b. Separator cards. 

• For each remote card reader configured at a remote terminal: Automatically started (hot) card reader. 

• A standard forms name of STD . in the standard forms parameter, or use STD . as the name of standard 
forms for both printers and punches. 
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Configuring the Host 



NOTE 



If Output Management, MRJETABL, is being used, specify an entry with 
STD. as a FORM ID. 



• Communication line: 

a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for communication through an SSLC. Less than or 
equal to 56000 bits per second for communication through an INP. 

c. EBCDIC and transparent. 

• Multileaving buffer size: Not to exceed 2000 characters. A large buffer size improves performance 
when the communication line operates at 5 6Kb. 

• All other generation parameters should be specified consistent with practices at the host site. 

Make note of the value being configured for the number of print lines per page. This value should be 
used as entry number 8 in the MRJE/3000 configuration file for this host. 



NOTE 



Consult with host system operations when your communications line is 
configured at 56Kb. Also, configure two printer streams for better 
subsystem performance at this speed. 



CONFIGURING A HASP SYSTEM 

For a HASP system, specify: 

• Terminal type: System/ 3 60, model 25 or higher. 

• Line printer width: 255 characters or less. 

• Console support: YES 

• Transparency: YES 

• Communications line: 

a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for communication through an SSLC. Less than or 
equal to 56000 bits per second for communication through an INP. 

c. EBCDIC and transparent. 

• Multileaving buffer size: Not to exceed 2000 characters. A large buffer size improves performance 
when the communication hne operates at 56Kb. 
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Configuring the Host 

• A standard forms name of STD. in the standard forms parameter, or use STD. as the name of standard 
forms for both printers and punches. 



NOTE 



If Output Management, MRJETABL, is being used, specify an entry with 
STD. as a FORM/D. 



• All other generation parameters should be specified consistent with practices at the host site. 

Make note of the value being configured for the number of print lines per page. This value should be 
used as entry number 8 in the MRJE/3000 configuration file for this host. 



NOTE 



Consult with host system operations when your communications line is 
configured at 56Kb. Also, configure two printer streams for better 
subsystem performance at this speed. 
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Configuring the Host 

CONFIGURING AN RSCS SYSTEM 

RSCS requires DMTSML as a driver. This defines the multileaving BSC protocol for a HASP workstation, 
with a console, one reader, one printer, and one punch at the host system. 

The host system operator must issue this command to start the line: 

START 'linkid' AUTO 



NOTE 



A host system operator should omit SETUP PAGES from the START 
command. This is a manual setup option. 



These characteristics are in effect: 

• Remote terminal type: S/ 360 is impHcit from the driver DMTSML configured at the host. 

• The terminal has these characteristics implied from the DMTSML driver: 

a. A console. 

b. A multileaving interface. 

c. The text transparency feature. 

• One remote printer configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started printer. 

c. No FCB support. 

d. Separator pages. 

e. Printer width: 255 characters or less. 

• One remote card punch configured at a remote terminal: 

a. Automatic forms mode. 

b. Automatically started punch. 

c. Separator cards. 

• One remote card reader configured at a remote terminal: Automatically started (hot) card reader. 

• STANDARD is the default host standard forms parameter name. This is configurable. 



NOTE 



Output Management, file MRJETABL, should be used. Specify an entry to 
match the standard forms name. If the default standard forms parameter 
name is used, specify STANDARD as a FORM ID. 
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Configuring the Host 



♦ Communication line: 



a. Full or half duplex 

b. Speed: less than or equal to 9600 bits per second for communication through an SSLC. Less than or 
equal to 56000 bits per second for communication through an INP. 

c. EBCDIC and transparent. 

• Multileaving buffer size: Not to exceed 2000 characters. A large buffer size improves performance 
when the communication line operates at 56Kb. 

• All other generation parameters should be specified consistent with practices at the host site. 

Only the n line of a banner is checked. Lines 1 through n-1 are not checked. Use MRJEMON with 
the DBUG'LINES secondary entry point to determine the number of lines sent in the printer stream. This 
value should be used as item number 8 in the MRJE/3000 configuration file for this host. 



NOTE 



Consult with host system operations when your communications line is 
configured at 56Kb. Also, configure two printer streams for better 
subsystem performance at this speed. 
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INTRODUCTION 



This appendix describes an exit procedure from MRJE/3000 used to process console special form setup 
messages from the host system. 



EXIT PROCEDURE OPERATION 



When communication with a host begins, MRJE/3000 determines that a procedure named 
MRJECONSOLE/i, the exit procedure, exists in SL. PUB. SYS. It prints this message at the system console, 
and on $STDLIST of the job or session issuing MRJECONTROL START,ft: 

MRJE EXIT PROCEDURE MRJECONSOLE/? ACCESSED 

MRJE/3000 calls MRJECONSOLE/? whenever a console message is received from the host system. 
MRJECONSOLEh returns a Unit number, a special form identification, and a host reply command to 
MRJE/3000 whenever a valid special form setup message is detected. 
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MRJECONSOLEh PROCEDURE 



An exit procedure to parse host console setup messages to change forms. 



Syntax 



Type small_int = 0..16; 

Function MRJECONSOLE/? (VAR WORK_AREA 

VAR RECORD 
LENGTH 
VAR FORM 
VAR REPLY 



PACKED ARRAY [1..10] OF CHAR; 

PACKED ARRAY [1..82] OF CHAR; 

0..82; 

PACKED ARRAY [1..8] OF CHAR; 

PACKED ARRAY [ 1 . . 1 1 ] OF CHAR) : 

SMALL INT; 



{ /? is the MRJE/3000 host id, an alphanumeric or blank character.) 



NOTE 



This syntax is in PASCAL/ 3 000. 



Parameters 



MRJECONSOLE/?, the 
Function Return 



WORK AREA 



RECORD 



LENGTH 



FORM 



The function, MRJECONSOLE/i should return zero (0) for all messages 
received in RECORD which were not host setup console messages. When a 
MRJECONSOLE/z detects a setup message, it should return an MPE Unit 
Number for the applicable pseudo printer or pseudo punch device. Printers 
1 through 7 correspond to MPE Units 3 through 9, respectively. Punches 1 
through 7 correspond to MPE Units 10 through 16, respectively. Any 
MRJECONSOLEft Function Return outside of the range of 3 through 1 6 is 
ignored by MRJE/3000. 

An input and output array reserved for MRJECONSOLEH to use as its own 
global storage. It is initialized to ASCII blank characters by MRJE/3000 
but never modified by it. MRJECONSOLEH can use WORK_AREA for its 
own flags. 

An input byte array up to 82 bytes long. This array contains a message 
sent by the host. All characters are in ASCII. The actual number of 
characters in RECORD is in LENGTH. While there may not be trailing 
blank characters in RECORD, the last character, RECORD[LENGTH], is a 
carriage return, a % 1 5 or hexadecimal OD. 

An input variable. The actual number of characters including the final 
carnage return in RECORD is in LENGTH. 

An output byte array 8 characters long. If MRJECONSOLEH issues a 
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REPLY 



legitimate Function Return, 3-16, to MRJE/3000, then this array must 
contain a valid form name left-justified with trailing blank characters. 
MRJE/3000 initializes this array to blank characters. 

An output byte array 1 1 characters long. This array should contain a host 
job entry system command to be transmitted by MRJE/3000 to the host to 
start the printer or punch corresponding to the Function Return value. See 
the Discussion for valid Function Returns. If you set the Function Return 
to 3, indicating Printer 1, then REPLY must contain a host job entry system 
command to start Printer 1. 

If the MRJECONSOLE/z Function Return is a value outside of the range of 
3-16, then REPLY has no meaning. 



Discussion 

This procedure is named MRJECONSOLEft, where h corresponds to a host ID letter or number; otherwise 
this procedure is named MRJECONSOLE. 

This procedure should issue a Function Return integer from 3 to 1 6 when a host console special forms 
setup message is detected in RECORD. If this function detects a special forms setup message in RECORD 
it should: 

• Return an integer to indicate a printer or punch: 



Return Value 


Device 


3 


Printer 1 


4 


Printer 2 


5 


Printer 3 


6 


Printer 4 


7 


Printer 5 


8 


Printer 6 


9 


Printer 7 


10 


Punch 1 


11 


Punch 2 


12 


Punch 3 


13 


Punch 4 


14 


Punch 5 


15 


Punch 6 


16 


Punch 7 



• Return a special form name, left -justified with trailing blank characters in FORM. 

• Return a host console command in REPLY to start transmitting the next applicable data set to a 
printer or punch. The values of the MRJECONSOLEAi Function Return and REPLY must correspond. 
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Example 



This Pascal/3000 program contains a sample exit procedure, and is supplied with MRJE/3000 in file 
Z00Z249A.HP30249.HPPL87. It is compiled into segment MRJESEG. 



$CHECK_ACTUAL_PARM 0;CHECK_FORMAL_PARM 0;STANDARD_LEVEL'HP3000'$ 
$SEGMENT 'MRJESEG' ;SUBPROGRAM 'MRJECONSOLEV*' ;XREF 0N$ 
PROGRAM MRJE EXIT OB; 



TYPE 

small_int 
record_length 
wo r k_a re a_ t y pe 
record_type 
form_type 
reply type 



= 0..16; 

= 0..82; 

= packed array [1.. 10] of char; 

= packed array[l..82] of char; 

= packed array[1..8] of char; 

= packed array [1.. 11] of char; 



PROCEDURE PRINT; INTRINSIC; 

FUNCTION MRJECONSOLEV (van work_area 

var console 

length 
var form 
var reply 



wo rk_a rea_ty pe ; 

record_type; 

record_length; 

forni_type; 

reply type) : small int; 



This function is called by MRJE/3000 with host id V to parse setup messages. A typical message 
generated by a host running VM/370 with RSCS follows: 

DTMAXM113I LINK DIAL01 PRINT MOUNT REQUIRED CLASS * FORM formid AUTO 
1234567890123456T8901 2345678901 2345676901234567890123456T890123456T8 

The string formid at column 58 is the name of the form to be mounted on Printer 1, MPE Unit 3. This 
function assumes all forms output is destined for Printer 1. The string DMTAXM1 131 uniquely identifies 
this message. The command to be sent back to the host to tell it to start Printer 1 is the START string 
passed into the reply array. 



VAR 

char_count , 
form_pos : integer; 
cmd_id : string[10]; 

begin 



{Location of the form name in the record} 
(ID of the "change forms" command) 



(Initialize) 

(Insure there are enough chars to check) 



mrjeconsolev := 0; 
if (length > 10) then 
begin 

strmove(10,console,1 ,cmd_id,1 ) ; (Move to string variable) 

setstrlen(cmd_id,10) ; (Insure correct length for str compare) 

if cmd_id = 'DMTAXM113I' then 

fc>e9in ('Change Forms' cmd . received!) 



E-4 



MRJECONSOLEh PROCEDURE 



char_count := 0; 

form_pos := 58; 

print(console, -length, 0) ; {This prints the record to $STDLIST} 

while (console [form_pos + char_count] <> ' ') and (char_count < 8) do 

char_count := char_count + 1; {Find position of the blank} 

strmove(char_count, console, form_pos,form,1 ) ; {Move to 'FORM'} 
reply := 'START'; {To return 'start' command} 

mrjeconsolev := 3; {Unit 3, printer 1} 

end; {If change forms command received} 

end; {If length > 10} 

end; {Function mrjeconsolev} 

begin 

{Null outer block} 

end. 
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Installing an Exit Procedure 

This sample stream job compiles a Pascal/3000 source file, Z00Z249A.HP30249.HPPL87 into usl 
file MRJEUSL. PUB.SYS Then SYSDUMP adds the segment MRJESEG, which contains the procedure 
MRJECONSOLEV as a relocatable binary module, to the system SL. 

job install, manager. sys, pub 
purge mrjeusl 
build mrjeusl ;code=usl 
continue 

pascal Z00Z249A.HP30249.HPPL87, mrjeusl 
if jcw<warn then 
file systape;dev=tape 
sysdump *systape 
Y <<CHANGES?>> 

<<SYSTEM ID>> 
<<MEMORY SIZE>> 
<<I0 CHANGES>> 
<<TABLE CHANGES>> 
<<MISC CHANGES>> 
<< LOGGING CHANGES >> 
<<DISC ALLOCATION CHANGES>> 
<<SCHEDULING CHANGES>> 
<<SEGMENT LIMIT CHANGES>> 
<<SYSTEM PROGRAM CHANGES >> 
<<SYSTEM SL CHANGES>> 
<<LIST LIBRARY>> 
<<DELETE SEGMENT>> 
<<REPLACE SEGMENT>> 
<<ADD SEGMENT>> 

<<SEG NAME, USL FILE NAME>> 
<<RETURN FOR NEXT SEGMENT PROMPT>> 
<<LIST LIBRARY>> 
<<DUMP DATE>> 
<<DUMP FILE SUBSETS>> 
<<LIST FILES>> 
! TELLOP SYSDUMP COMPLETED. 

! TELLOP PERFORM AN UPDATE FROM THE SYSTAPE. 
!ELSE 

! TELLOP PROGRAM COMPILE FAILED. 
!END IF 
?EOJ 



N 
N 
N 
N 
N 
N 
N 
N 
Y 
N 
N 
N 
Y 
MRJESEG, MRJEUSL 

N 

9/9/99 

MRJE@. PUB.SYS 
N 
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APPENDIX 



INTRODUCTION 

MRJE/3000 can match environment file names with form names to print host job output on HP 2680A 
Laser Printers; however, the more flexible method described in Output Management is preferred. 

Method 

In order to route MRJE job output to an HP2680A, the printer must be spooled and must have been 
configured with a device class of LPS . 

It is not necessary to use Environment Files when directing output to the HP2680A; some or all of the 
output data sets from a job may be printed without using Environment Files. If Environment Files are 
not used, output will be printed as on a standard printer. 

Do the following to print output using Environment Files: 

. The group ENV and account HP2680 are required.. If it does not exist, it must be created. 

• Log on to group ENV and account HP2680 and build your Environment Files. 



NOTE 



The names of Environment Files to be referenced by MRJE/3000 as special 
forms must be four characters long, or less. 



. Enter the name of the file in the forms subparameter of the SYSOUT parameter in your job's JCL. 
The forms subparameter is the third subparameter of the SYSOUT parameter in the DD statement. 

. Then when your output is received from the host, MRJE/3000 will use the file named in forms to 
create the forms and print the output contained in the SYSOUT data set. If MRJE/3000 is unable to 
find the Environment File in ENV. HP2680, a forms message for the data set will be sent to the console, 
asking the operator to mount special forms. 

• Different data sets in the same job can specify different Environment Files, or no file at all. 

If you are using alternate character sets, include the special codes needed to switch from one set to the 
other. The special codes may be built into each ASCII character in your data, or the ASCII Shift -In and 
Shift-Out characters may be embedded in the data to cause a shift from one set to the other. The special 
code is built into each character by turning the character's eighth bit on or off. When the bit is off, the 
character is printed from your primary character set; when the bit is on it is printed from your secondary 
character set. As an alternative to this method, you may embed the Shift-In and Shift-Out characters m 
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each data record wherever you want to switch between character sets. The Shift-In character (octal 17) 
causes the characters that follow to be from your primary set. Shift-Out (octal 16) causes the subsequent 
characters to be from your secondary character set. Each Shift-In or Shift-Out remains in force until 
the end of the record, or until another Shift-In or Shift-Out character is encountered. 

If no special codes are included in your data, all characters will be printed from your primary character 
Environment Files cannot be specified for JCL message output. 

Example of the Use of Environment Files 

//EXAMPLE JOB (ACCOUNT) , PROGRAMMER 
//STEP EXEC PGM=TEST2680 
//MAINOUT DD SYSOUT=(A, ,F001 ) 
//SECOUT DD SYSOUT=(A,,F002) 

In this example, the output for MAINOUT will be printed using Environment File F001.ENV.HP2680 
The output for SECOUT will be printed using Environment File F002.ENV.HP2680. No forms-mount 
messages will be displayed when the output is printed. 

If MRJE/3000 is unable to find file F002.ENV.HP2680, a forms mount message for SECOUT will be 
displayed on the HP 3000 system console. 

Refer to Interactive Formatting System Reference Guide, HP 36580-90001, for more information on the 
use of Environment Files. 



F-2 



APPENDIX 




INTRODUCTION 

This is a selected glossary of terms related to MRJE/3000. 
These are some comprehensive data processing dictionaries: 

• Compute f Dictionary, C. J. Sippl & R. J. Sippl; Howard W. Sams & Co, Inc. ,1 982 

• Data Communications Dictionary, C. J. Sippl; Van Nostrand Reinhold, 1976 

• Data Processing Glossary (IBM GC20- 1 699) 
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& 



, and / 
actual file 
blanks 



card 



Console Operator, 
MRJE/3000 



current host 



default host 



The initial character of a Global File Equation reference in a SUBMIT command. 

A pair of double quotation marks identify an MPE device class name, "name". 

This (#) is the MRJE/3000 subsystem prompting character for terminal input. It is 
displayed at the terminal of a user whenever MRJE/3000 is ready to accept a 
command. 

When used at the end of an MRJE/3000 command line, or an entry in 
MRJETABL, an ampersand (&) that information is continued on the next line. 

A pair of single quotation marks indentifies an entry in MRJETABL, 'name'. 

See delimiters. 

A file resident on disc. 

Commands can be preceded by blanks; they need not start in column 1 of a card 
image. At least one blank or a comma is required to separate command 
parameters. 

Valid Commands: 

#DISPLAY C,9 
#DISPLAY C, 9 
# DISPLAY C,9 

Invalid Command: 

#DISPLAYC,9 

The word card is interchangeable with card image. Each represents an 
80-character record of stored information. 

The person who operates a HP 3 000 system console and I/O devices, and any other 
person authorized to control a communication link between a HP3000 and a 
remote host. 

The host to which all jobs and host console commands are sent, until another host is 
selected by means of the HOST command. Unless the MRJE/3000 user issues the 
HOST command, the current host is always the same as the default host. 

The host system which is selected, by default, for MRJE/3000 job and host console 
command processing when an MRJE command is issued from MPE. All jobs and 
commands are sent to this host until another host is specified by a HOST command. 
A default host is also a host system whose communication line is affected when a 
Console Operator issues an MRJECONTROL command from MPE without 
specifying a host ID. 
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delimiters 



Commas are optional except within joblist or itemlist. A slash (|) signifies a range 
of values beginning with the number to its left of the slash and ending with the 
number to the right. 



Valid Commands: 



#DISPLAY JOB 25 
#DISPLAY,J0B,25 

#ALTER 5,7 
#ALTER 5/7 



Items 5 and 7 are affected. 
Items 5 through 7 are affected. 



Invalid Command: 



#ALTER 5 6 



Form ID 



host 



A comma must separate 5 from 6 . 

A form identifier in MRJETABL. A Form ID is a string of eight characters, or 
less. It is composed of alphanumeric characters, IBM National characters (#, $, or 
@), or a period. A Form ID reference, as in a SUBMIT command, or a 
configuration file item, must be delimited by single quote marks. 

A mainframe system on which jobs and host console commands submitted and 
executed through MRJE/3000. It is not an HP3000. Multiple hosts can be 
attached to an HP 3 000. 



host ID 



An alphanumeric name by which a host is identified. A user of MRJE/3000 
specifies a host ID, or its first character, in the hostid parameter that is part of 
several MRJE/3000 commands. MRJE/3000 uses only the first character of the 
host ID in its communication with MRJE/3000 Users and Managers. If a blank 
character or no character is used as a host ID, the default host is intended. 



host number 



A number the host system assigns to a job when it is received. The user need not 
usually remember this number. 
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itemlist or joblist Some commands permit a list or range of parameters to be specified: 

job#,job#/job# 

jobname , jobname , jobname 



job name 



job number 

MRJE/3000 
Manager 

or 
Manager, 
capitalized 

MRJE/3000 User 

or 
User, capitalized 

output 

solicited output 



system file 



unsolicited output 



item# [,item#] [/item#] 

In these commands the parameters can be repeated and jobjl and jobname 
intermixed. 

ALTER 25 

ALTER 2/7,25,1,12/15 

CANCEL JOB 6 

CANCEL JOB 3/5, J0BXYZ,8 

The last command cancels jobs 3 through 5 , JOBXYZ, and 8. 

A user -assigned name to identify a job. It need not be unique. The MRJE/3000 
User specifies job names on host system job control language JOB cards in job input 
files, and in the jobname parameter that is part of several MRJE/3000 commands. 

A number MRJE/3000 assigns to a job when it is submitted. Note this number 
for future commands that reference the job. 

The person who plans MRJE/3000 use and enters MRJE/3000 manager 
commands to build MRJE/3000 Configuration Files and to monitor the activity of 
the subsystem. 



A person who accesses the MRJE/3000 subsystem, in either batch or session mode, 
to submit jobs for processing on a host system. A Manager can also be an 
MRJE/3000 User. 

See solicited output and unsolicited output. 

Solicited output consists of data sets received from a host that are recognized by 
MRJE/3000 as jobs that were submitted, solicited, through it. Output received is 
recognized as originating from a remote workstation. 

A system defined file designator indicating those files that MPE identifies for a job 
or session. These are $STDIN, $STDINX, SSTDLIST, $NULL, $OLDPASS, and 

SNEWPASS. 

Unsolicited output consists of data sets received from a host that are not recognized 
by MRJE/3000 as jobs that were submitted, solicited, through it. Output received 
is not recognized as originating from a remote workstation. 
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user Anyone; a Manager, User, or Console Operator who uses MRJE/3000. 

(in lower case) 
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ASCII 
Character 



A 
B 
C 

D 
E 
F 
G 
H 
I 

J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 

z 





1 

2 
3 
4 
5 
6 
7 
8 
9 

NUL 
SOH 
STX 
ETX 
EOT 
ENQ 



First Character 
Octal Equivalent 



040400 
041000 
041400 
042000 
042400 
043000 
043400 
044000 
044400 
045000 
045400 
046000 
046400 
047000 
047400 
050000 
050400 
051000 
051400 
052000 
052400 
053000 
053400 
054000 
054400 
055000 

060400 
061000 
061400 
062000 
062400 
063000 
063400 
064000 
064400 
065000 
065400 
066000 
066400 
067000 
067400 
070000 
070400 
071000 
071400 
072000 
072400 
073000 
073400 
074000 
074400 
075000 

030000 
030400 
031000 
031400 
032000 
032400 
033000 
033400 
034000 
034400 

000000 
000400 
001000 
001400 
002000 
002400 



Table H- 1. ASCII Character Set 



Second Character 
Octal Equivalent 



000101 

000102 

000103 

000104 

000105 

000106 

000107 

000110 

0001 1 1 

000112 

000113 

000114 

000115 

000116 

0001 1 7 

000120 

000121 

000122 

000123 

000124 

000125 

000126 

0001 27 

000130 

000131 

000132 

000141 

000142 

000143 

000144 

000145 

000146 

000147 

000150 

000151 

000152 

000153 

000154 

000155 

000156 

000157 

000160 

000161 

000162 

000163 

000164 

000165 

000166 

000167 

0001 70 

000171 

0001 72 

000060 
000061 
000062 
000063 
000064 
000065 
000066 
000067 
000070 
000071 

000000 
000001 
000002 
000003 
000004 
000005 



ASCII 
Character 



ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
OR 
SO 

SI 
OLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 

EM 
SUB 
ESC 

FS 

GS 

RS 

US 

SPACE 

I 



} 
DEL 



First Character 
Octal Equivalent 



003000 

003400 

004000 

004400 

005000 

005400 

006000 

006400 

007000 

007400 

010000 

010400 

011000 

011400 

012000 

012400 

013000 

013400 

014000 

014400 

015000 

015400 

016000 

016400 

017000 

017400 

020000 

020400 

021000 

021400 

022000 

022400 

023000 

023400 

024000 

024400 

025000 

025400 

026000 

026400 

027000 

027400 

035000 

035400 

036000 

036400 
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Second Character 
Octal Equivalent 



000006 

000007 

000010 

00001 1 

000012 

000013 

000014 

000015 

000016 

000017 

000020 

000021 

000022 

000023 

000024 

000025 

000026 

000027 

000030 

000031 

000032 

000033 

000034 

000035 

000036 

000037 

000040 

000041 

000042 

000043 

000044 

000045 

000046 

000047 

000050 

000051 

000052 

000053 

000054 

000055 

000056 

000057 

000072 

000073 

000074 

000075 



First Character 



Second Character 



J< 



A. 



037000 


000076 


037400 


000077 


040000 


000100 


055400 


000133 


056000 


000134 


056400 


000135 


057000 


000136 


057400 


000137 


060000 


000140 


075400 


0001 73 


076000 


0001 74 


076400 


0001 75 


077000 


0001 76 


077400 


0001 77 



r 

1 


Y > 

' 1 

















1 2 3 


4 5 6 


7 8 9 


10 11 12 


13 14 15 
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Table H-2. ASCII-EBCDIC-HoUerith Conversions 



HOW TO USE THIS TABLE 

• The table is sorted by character code, each code being represented by its decimal, octal, and hexadecimal 
equivalent. 

• Each row of the table gives the ASCII and EBCDIC meaning of the character code, the ASCII**EBCDIC 
conversion code, and the Hollerith representation (punched card code) for the ASCII character. 

The following examples describe several ways of using the table: 

Example 1 : Suppose you want to determine the ASCII code for the $ character. Scan down the ASCII graphic column 
until you locate $, then look left on that row to find the character code - 36 (dec), 044 (oct) and 24 (hex) This is the 
code used by an ASCII device (terminal, printer, computer, etc.) to represent the $ character. Its Hollerith punched card 
code IS 1 1-3-8. 

Example 2: The character code 5B (hex) is the EBCDIC code for what character? Also, when 5B is converted to ASCII 
(for example, by FCOPY with the EBCDICIN option), what is the octal character code? First, locate 5B in the hex 
character code column and move right on that row to the EBCDIC graphic which is $. The next column to the right 
gives the conversion to ASCII, 044. As a check, find 044 (oct) in the character code column, look right to the ASCII 
graphic column and note that $ converted to EBCDIC is 133 (oct) which equals 5B (hex) 



CHAR CODE 


ASCII 


EBCDIC 1 


Dec 


Oct 


Hex 


CntI/ 


to 
EBCDIC 


Hollerith 


Cnti/ 


to 
ASCII 










(Oct) 




Gph 


(Oct) 





000 


00 


NUL 


000 


12-0-1-8-9 


NUL 


000 


1 


001 


01 


SDH 


001 


12-1-9 


SON 


001 


2 


002 


02 


STX 


002 


12-2-9 


STX 


002 


3 


003 


03 


ETX 


003 


1 2-3-9 


ETX 


003 


4 


004 


04 


EOT 


067 


7-9 


PF 


234 


5 


005 


05 


ENQ 


055 


0-5-8-9 


HT 


Oil 


6 


006 


06 


ACK 


056 


0-6-8-9 


LC 


206 


7 


007 


07 


BEL 


057 


0-7-8-9 


DEL 


177 


8 


010 


08 


BS 


026 


11-69 




227 


9 


Oil 


09 


HT 


005 


12-5-9 




215 


10 


012 


OA 


LF 


045 


0-5-9 


SMM 


216 


11 


013 


OB 


VT 


013 


12-3-8-9 


VT 


013 


12 


014 


00 


FF 


014 


1 2-4-8-9 


FF 


014 


13 


015 


OD 


OR 


015 


12-5-8-9 


OR 


015 


14 


016 


OE 


SO 


016 


12-6-8-9 


SO 


016 


15 


017 


OF 


SI 


017 


12-7-8-9 


SI 


017 


16 


020 


10 


DLE 


020 


12-11-1-8-9 


DLE 


020 


17 


021 


11 


DC1 


021 


11-1-9 


DC1 


021 


18 


022 


12 


DC2 


022 


11-2-9 


DC2 


022 


19 


023 


13 


DC3 


023 


11-3-9 


TM 


023 


20 


024 


14 


DC4 


074 


4-8-9 


RES 


235 


21 


025 


15 


NAK 


075 


5-8-9 


NL 


205 


22 


026 


16 


SYN 


062 


2-9 


BS 


010 


23 


027 


17 


ETB 


046 


0-6-9 


IL 


207 


24 


030 


18 


CAN 


030 


11-8-9 


CAN 


030 


25 


031 


19 


EM 


031 


11-1-8-9 


EM 


031 


26 


032 


1A 


SUB 


077 


7-8-9 


CC 


222 


27 


033 


IB 


ESC 


047 


0-7-9 


GUI 


217 


28 


034 


1C 


FS 


034 


11-4-8-9 


IFS 


034 


29 


035 


ID 


GS 


035 


11-5-8-9 


IGS 


035 


30 


036 


IE 


RS 


036 


11-6-8-9 


IRS 


036 


31 


037 


IF 


US 


037 


11-7-8-9 


lUS 


037 


32 


040 


20 


SP 


100 


Blank 


DS 


200 


33 


041 


21 


! 


117 


12-7-8 


SOS 


201 


34 


042 


22 




177 


7-8 


FS 


202 


35 


043 


23 


# 


173 


3-8 




203 


36 


044 


24 


$ 


133 


11-3-8 


BYP 


204 


37 


045 


25 


% 


154 


0-4-8 


LF 


012 


38 


046 


26 


& 


120 


12 


ETB 


027 


39 


047 


27 




175 


5-8 


ESC 


033 


40 


050 


28 


( 


115 


12-5-8 




210 


41 


051 


29 


) 


135 


11-5-8 




211 


42 


052 


2A 


* 


134 


11-4-8 


SM 


212 


43 


053 


2B 


+ 


116 


12-6-8 


CU2 


213 


44 


054 


2C 


, 


153 


0-3-8 




214 


45 


055 


2D 


- 


140 


11 


ENQ 


005 


46 


056 


2E 




113 


12-3-8 


ACK 


006 


47 


057 


2F 


/ 


141 


0-1 


BEL 


007 



CHAR CODE 


ASCII 


EBCDIC 


Dec 


Oct 


Hex 


CntI/ 


to 
EBCDIC 


Hollerith 


CntI/ 


to 
ASCII 








Gph 


(Oct) 




Gph 


(Oct) 


48 


060 


30 





360 







220 


49 


061 


31 


1 


361 


1 




221 


50 


062 


32 


2 


362 


2 


SYN 


026 


51 


063 


33 


3 


363 


3 




223 


52 


064 


34 


4 


364 


4 


PN 


224 


53 


065 


35 


5 


365 


5 


RS 


225 


54 


066 


36 


6 


366 


6 


UC 


226 


55 


067 


37 


7 


367 


7 


EOT 


004 


56 


070 


38 


8 


370 


8 




230 


57 


071 


39 


9 


371 


9 




231 


58 


072 


3A 




172 


2-8 




232 


59 


073 


3B 




136 


11-6-8 


CU3 


233 


60 


074 


3C 


< 


114 


12-4-8 


DC4 


024 


61 


075 


3D 


= 


176 


6-8 


NAK 


025 


62 


076 


3E 


> 


156 


0-6-8 




236 


63 


077 


3F 


? 


157 


0-7-8 


SUB 


032 


64 


100 


40 


@ 


174 


4-8 


SP 


040 


65 


101 


41 


A 


301 


12-1 




240 


66 


102 


42 


B 


302 


12-2 




241 


67 


103 


43 


C 


303 


12-3 




242 


68 


104 


44 


D 


304 


12-4 




243 


69 


105 


45 


E 


305 


12-5 




244 


70 


106 


46 


F 


306 


12-6 




245 


71 


107 


47 


G 


307 


12-7 




246 


72 


110 


48 


H 


310 


12-8 




247 


73 


111 


49 


1 


311 


12-9 




250 


74 


112 


4A 


J 


321 


11-1 


i 


133 


75 


113 


4B 


K 


322 


11-2 




056 


76 


114 


4C 


L 


323 


11-3 


< 


074 


77 


115 


4D 


M 


324 


11-4 


( 


050 


78 


116 


4E 


N 


325 


11-5 


+ 


053 


79 


117 


4F 





326 


11-6 


1 


041 


80 


120 


50 


P 


327 


11-7 


& 


046 


81 


121 


51 


O 


330 


11-8 




251 


82 


122 


52 


R 


331 


11-9 




252 


83 


123 


53 


S 


342 


0-2 




253 


84 


124 


54 


T 


343 


0-3 




254 


85 


125 


55 


U 


344 


0-4 




255 


86 


126 


56 


V 


345 


0-5 




256 


87 


127 


57 


w 


346 


0-6 




257 


88 


130 


58 


X 


347 


0-7 




260 


89 


131 


59 


Y 


350 


0-8 




261 


90 


132 


5A 


z 


351 


0-9 


1 


135 


91 


133 


58 


[ 


112 


12-2-8 


$ 


044 


92 


134 


5C 


\ 


340 


0-2-8 


* 


052 


93 


135 


5D 


] 


132 


11-2-8 


) 


051 


94 


136 


5E 


A 


137 


11-7-8 




073 


95 


137 


5F 


— 


155 


0-5-8 


— 1 


136 
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ASCII/EBCDIC Character Tables 



Table H-2. ASCII-EBCDIC-Hollerith Conversions (continued) 



CHAR CODE 


ASCII 1 


EBCDIC 


Dec Oct Hex 


CntI/ 
Gph 


to 

EBCDIC 

(Oct) 


Hollerith 


C"«'/ ASCII 
°P'' (Oct) 


96 140 60 




171 


1-8 


- 


055 


97 141 61 


a 


201 


12-0-1 


/ 


057 


98 142 62 


b 


202 


12-0-2 




262 


99 143 63 


c 


203 


12-0-3 




263 


100 144 64 


d 


204 


12-0-4 




264 


101 145 65 


e 


205 


12-0-5 




265 


102 146 66 


f 


206 


12-0-6 




266 


103 147 67 


g 


207 


12-0-7 




267 


104 150 68 


h 


210 


12-0-8 




270 


105 151 69 


i 


211 


12-0-9 




271 


106 152 6A 


i 


221 


12-11-1 


1 


174 


107 153 6B 


k 


222 


12-11-2 


' 


054 


108 154 6C 


1 


223 


12-11-3 


% 


045 


109 155 6D 


m 


224 


12-11-4 





137 


110 156 6E 


n 


225 


12-11-5 


> 


076 


111 157 6F 





226 


12-11-6 


? 


077 


112 160 70 


P 


227 


12-11-7 




272 


113 161 71 


q 


230 


12-11-8 




273 


114 162 72 


r 


231 


12-11-9 




274 


115 163 73 


s 


242 


11-0-2 




275 


116 164 74 


t 


243 


11-0-3 




276 


117 165 75 


u 


244 


11-0-4 




277 


118 166 76 


V 


245 


11-0-5 




300 


119 167 77 


w 


246 


11-0-6 




301 


120 170 78 


X 


247 


11-0-7 




302 


121 171 79 


V 


250 


11-0-8 




140 


122 172 7A 


z 


251 


11-0-9 


# 


072 


123 173 7B 


( 


300 


12-0 


043 


124 174 70 


1 


152 


12-11 


@ 


100 


125 175 7D 


]^ 


320 


11-0 


' 


047 


126 176 7E 




241 


11-0-1 


= 


075 


127 177 7F 


DEL 


007 


1 2-7-9 




042 


128 200 80 




040 


11-0-1-8-9 




303 


129 201 81 




041 


0-1-9 


a 


141 


130 202 82 




042 


0-2-9 


b 


142 


131 203 83 




043 


0-3-9 


c 


143 


132 204 84 




044 


0-4-9 


d 


144 


133 205 85 




025 


11-5-9 


e 


145 


134 206 86 




006 


12-6-9 


f 


146 


135 207 87 




027 


11-7-9 


9 


147 


136 210 88 




050 


0-8-9 


h 


150 


137 211 89 




051 


0-1-8-9 


i 


151 


138 212 8A 




052 


0-2-8-9 




304 


139 213 8B 




053 


0-3-8-9 




305 


140 214 8C 




054 


0-4-8-9 




306 


141 215 8D 




Oil 


1 2-1 -8-9 




307 


142 216 8E 




012 


12-2-8-9 




310 


143 217 8F 




033 


11-3-8-9 




311 


144 220 90 




060 


1 2-1 1 -0-1 -8-E 




312 


145 221 91 




061 


1-9 


i 


152 


146 222 92 




032 


1 1 -2-8-9 


k 


153 


147 223 93 




063 


3-9 


1 


154 


148 224 94 




064 


4-9 


m 


155 


149 225 95 




065 


5-9 


n 


156 


1 50 226 96 




066 


6-9 


o 


157 


151 227 97 




010 


12-8-9 


P 


160 


1 52 230 98 




070 


8-9 


q 


161 


153 231 99 




071 


1-8-9 


r 


162 


154 232 9 A 




072 


2-8-9 




313 


155 233 98 




073 


3-8-9 




314 


1 56 234 90 




004 


12-4-9 




315 


157 235 9D 




024 


1 1 -4-9 




316 


158 236 9E 




076 


6-8-9 




317 


159 237 9F 




341 


11-0-1-9 




320 


160 240 AO 




101 


12-0-1-9 




321 


161 241 A1 




102 


12-0-2-9 


~' 


176 


162 242 A2 




103 


12-0-3-9 


s 


163 


163 243 A3 




104 


12-0-4-9 


t 


164 


164 244 A4 




105 


12-0-5-9 


u 


165 


165 245 A5 




106 


12-0-6-9 


V 


166 


166 246 A6 




107 


12-0-7-9 


w 


167 


167 247 A7 




110 


12-0-8-9 


X 


170 


168 250 A8 




111 


12-1-8 


V 


171 


169 251 A9 




121 


12-11-1-9 


z 


172 


170 252 AA 




122 


12-11-2-9 




322 


171 253 AB 




123 


12-11-3-9 




323 


172 254 AC 




124 


12-11-4-9 




324 


173 255 AD 




125 


12-11-5-9 




325 


174 256 AE 




126 


12-11-6-9 




326 


175 257 AF | 




12-11-7-9 




327 



CHAR CODE 


ASCII 


EBCDIC 


Dec Oct Hex 


CntI/ 
Gph 


to 

EBCDIC 

(Oct) 


Hollerith 


C""/ ASCII 
^P*' (Oct) 


1 76 260 BO 




130 


12-11-8-9 




330 


177 261 B1 




131 


11-1-8 




331 


178 262 82 




142 


1 1 0-2-9 




332 


179 263 83 




143 


11-0-3-9 




333 


180 264 84 




144 


1 1 -0-4-9 




334 


181 265 B5 




145 


1 1 -0-5-9 




335 


182 266 B6 




146 


1 1 -0-6-9 




336 


183 267 B7 




147 


11-0-7-9 




337 


184 270 88 




150 


1 1 -0-8-9 




340 


185 271 B9 




151 


0-1-8 




341 


186 272 BA 




160 


12-11-0 




342 


187 273 BB 




161 


12-11-0-1-9 




343 


1 88 274 BC 




162 


12-11-0-2-9 




344 


189 275 BD 




163 


12-11-0-3-9 




345 


190 276 BE 




164 


12-11-0-4-9 




346 


191 277 BF 




165 


12-11-0-5-9 




347 


192 300 CO 




166 


12-11-0-6-9 


{ 


173 


193 301 01 




167 


12-11-0-7-9 


A 


101 


194 302 02 




170 


12-11-0-8-9 


B 


102 


195 303 03 




200 


1 2-0-1 -8 





103 


1 96 304 04 




212 


12-0-2-8 


D 


104 


197 305 05 




213 


12-0-3-8 


E 


105 


198 306 06 




214 


12-0-4-8 


F 


106 


199 307 07 




215 


1 2-0-5-8 


G 


107 


200 310 08 




216 


1 2-0-6-8 


H 


110 


201 311 09 




217 


1 2-0-7-8 


1 


111 


202 312 OA 




220 


12-11-1-8 




350 


203 313 OB 




232 


12-11-2-8 




351 


204 314 00 




233 


12-11-3-8 


J^ 


352 


205 315 00 




234 


1 2-1 1 -4-8 




353 


206 316 OE 




235 


12-11-5-8 


'V 


354 


207 317 OF 




236 


12-11-6-8 




355 


208 320 DO 




237 


1 2-1 1 -7-8 


} 


175 


209 321 D1 




240 


11-0-1-8 


J 


112 


210 322 D2 




252 


11-0-2-8 


K 


113 


211 323 D3 




253 


11-0-3-8 


L 


114 


21 2 324 D4 




254 


11-0-4-8 


M 


115 


213 325 D5 




255 


11-0-5-8 


N 


116 


21 4 326 D6 




256 


11-0-6-8 


O 


117 


215 327 D7 




257 


11-0-7-8 


P 


120 


216 330 D8 




260 


12-11-0-1-8 


Q 


121 


217 331 D9 




261 


12-11-0-1 


R 


122 


218 332 DA 




262 


12-11-0-2 




356 


219 333 DB 




263 


12-11-0-3 




357 


220 334 DO 




264 


12-11-0-4 




360 


221 335 DD 




265 


12-11-0-5 




361 


222 336 DE 




266 


12-11-0-6 




362 


223 337 DF 




267 


12-11-0-7 




363 


224 340 EO 




270 


12-11-0-8 


\ 


134 


225 341 El 




271 


12-11-0-9 




237 


226 342 E2 




272 


1 2-1 1 -0-2-8 


S 


123 


227 343 E3 




273 


12-11-0-3-8 


T 


124 


228 344 E4 




274 


1 2-1 1 -0-4-8 


U 


125 


229 345 E5 




275 


12-11-0-5-8 


V 


126 


230 346 E6 




276 


1 2-1 1 -0-6-8 


w 


127 


231 347 E7 




277 


12-11-0-7-8 


X 


130 


232 350 E8 




312 


12-0-2-8-9 


Y 


131 


233 351 E9 




313 


1 2-0-3-8-9 


z 


132 


234 352 EA 




314 


12-0-4-8-9 




364 


235 353 EB 




315 


12-0-5-8-9 




365 


236 354 EO 




316 


12-0-6-8-9 


ri 


366 


237 355 ED 




317 


12-0-7-8-9 




367 


238 356 EE 




332 


12-11-2-8-9 




370 


239 357 EF 




333 


1 2-1 1 -3-8-9 




371 


240 360 FO 




334 


12-11-4-8-9 





060 


241 361 F1 




335 


1 2-1 1 -5-8-9 


1 


061 


242 362 F2 




336 


12-11-6-8-9 


2 


062 


243 363 F3 




337 


12-11-7-8-9 


3 


063 


244 364 F4 




352 


11-0-2-8-9 


4 


064 


245 365 F5 




353 


11-0-3-8-9 


5 


065 


246 366 F6 




354 


1 1 -0-4-8-9 


6 


066 


247 367 F7 




355 


11-0-5-8-9 


7 


067 


248 370 F8 




356 


11-0-6-8-9 


8 


070 


249 371 F9 




357 


11-0-7-8-9 


9 


071 


250 372 FA 




372 


1 2-1 1 -0-2-8- 


9 1 


372 


251 373 FB 




373 


12-11-0-3-8- 


9 


373 


252 374 FO 




374 


12-11-0-4-8 


9 


374 


253 375 FD 




375 


12-11-0-5-8 


9 


375 


254 376 FE 




376 


12-11-0-6-8 


9 


376 


255 377 FF 




377 


12-11-0-7-8 


9 EO 


377 
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SPECIAL CHARACTERS 

! character, definition, G-2 

" character, definition, G-2 

# character, definition, G-2 

& character, definition, G-2 

' character, definition, G-2 

, character, definition, G-2 

: character in MPE commands, 3-23 

/ character, definition, G-2 



Activate communications Hnk trace, 5-2 

actual file, definition, G-2 

Additional Drivers, C-4 

ALL, PURGE parameter, 4-36 

ALL, trace option, 5-9 

ALTER, 4-25 

Alternate Character Sets, LASER Printers and, 4-1 

ASCII Translation, EBCDIC to, 2- 1 

ASP command, 3-2, 3-21, 4-24 

ASP System, Configuring a JES3 or, D-2 

Audience, viii 



B 



blanks, definition, G-2 
BSC Link, 4-2 
Building 

Configuration File, 4-24 

Files for MRJE/3000 Management, 4-3 

Host Console Message Logging Files, B-5 

MRJE/3000 

Configuration Files, B-4 
Stream Files, B- 5 
Building MRJETABL, Considerations for, 4-11 



CANCEL, 3-3, 4-27 
Cancel one or more 

jobs, 4-24 

User's jobs, 3-2 
card image, definition, G-2 
Card Punches, Pseudo, C-4 
Card Readers, Pseudo, C-4 
card, definition, G-2 



INDEX- 1 



Index 



Carriage Control Translation, 2-9 

Carriage Controls, Host - HP 3 000, Table 2-1, 2-10 

Catalog, MRJE/3000 Message, Table 6-4, 6-46 

Causes of Unsolicited Output, 4-42 

Change items in the Configuration File, 4-24 

CHECK, MR JECONTROL, 5-11 

Close communications link immediately, 5-2 

Close communications link, orderly, 5-2 

Commands 

Available to the MRJE/3000 User, 3-1 
Errors, 6-13 
Host Console, 4-40 
Manager, 4-24 
MRJECONTROL, 5-2 
MRJE/3000 Manager discussion in italics. 
ALTER, 4-25 
CANCEL, 3-3, 4-27 
DISPLAY, 3-6,4-30 
Host Console, 3-21 
EXIT, 3-9 
HELP, 3-10 
HOST, 3-11 
MPE, 3-23 
NEW, 4-33 
PURGE 4-36 
SUBMIT, 3-12 
Summary of MRJE Manager, Table 4-1, 4-24 
Summary of MRJE User, Table 3-1, 3-2 
Common Information, 6-15 
Common to All Devices, Configuration, C-17 
Common to All Devices, Configuration Dialog, C-8 
Communications 

Controller, 4-l,C-l 
line, 

high speed, 1 - 8 
Opening, 5-4 
link 

Control of, 5-1 
Information, 6-16 
trace activate, 5-2 
trace deactivate, 5-2 
CONFIG, 3-6 
Configuration Dialog, C-7 

Common to All Devices, C-8, C- 1 7 
for an INP or SSLC, C-10 
MRJE/3000 Pseudo Device, C- 1 4 
Configuration File, 1-5, 4-7 
Building MRJE/3000, B-4 
Contents, A-1 
Entries, Description of. A- 7 

MRJE/3000, Table A-1, A- 3 
Configuration Requirements, C- 1 

Summary, INP and SSLC, Table C-1, C-20 
Configured into MPE I/O, MRJE/3000, Figure C-1, C-6 
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Index 



Configuring 

ASP System, D-2 

HASP System, D- 3 

INP or SSLC for Several Subsystems, C-20 

JES 2 System, D-1 

JES3 System, D-2 

MPE to Inlcude MRJE/3000, C- 1 

RSCS System, D- 5 

SSLC for Several Subsytstems, C-20 

the Host, D-1 
CONFIG, DISPLAY parameter, 4-30 
Considerations for Building MRJETABL, 4-1 1 
Console Commands, Host, 4-40 
Console Message, 6-35 

Format, 6-33 

Items, 6-33 

Logging Facility, Host, 4-41 

Logging Files, Building Host, B-5 

MR JECONTROL, Table 6-2, 6-31 
Console Operator, 

Designating, 5-1 

MR JE/ 3000, definition, G - 2 
Console, MRJE Messages Sent to. Table 6-3, 6-35; 6-33 
Console, Pseudo, C-2 
Contents, Configuration File, A-1 
Control of the Communications Link, 5-1 
Controllers, Communcations, 4- 1, C- 1 
Controlling Unsolicited Output, 4-43 
Controls, 

Host - HP 3000 Carriage, Table 2-1, 2-10 

Carriage, Translation, 2-9 
Conventions, xii 
CS Errors, 6-14 
current host, definition, G-2 



D 

DBUG Entry Point, 6-2 

DBUG'LINES Entry Point, 6-9 

Deactivate communications Hnk trace, 5-2 

default host, definition, G-2 

Default Output to Unsolicited Devices, Routing, 2-13 

Definitions, G-2 

Description of Configuration File Entries, A- 7 

Designating an MRJE/3000 Console Operator, 5-1 

Destination Hierarchy, Job Output, Figure 2-3, 2-7 

Device 

Configuration Dialog, MRJE/3000 Pseudo, C-8, C-14, C-17 

Information, General Pseudo, C-5 

Pseudo, 4-2 

Routing, Unsolicited Output, 2-14 
Dialog 

Common to All Devices, Configuration, C-8, C-17 



INDEX- 3 



Index 



Configuration, C-7 

INP or SSLC Configuration, C-10 

Pseudo Device Configuration, C-14 

Directory File, 1-6, 4-7 

DISPLAY, 3-6, 4-30 

Display information, 3-2, 4-24 

Display, Using, 4-31 

Download Files, C-5 

Drivers, Additional, C-4 



EBCDIC to ASCII Translation, 2-10 

Elements of a Data Communication System, Fig. 1-1, 1 

Enter a job for transmission to the current host, 3-2 

Entries, 

Description of Configuration File, A- 7 

MRJE/3000 Configuration File, Table A-1, A-3 

Summary of Configuration File, A-1 
Entry Point, 

DRUG, 6-2 

DBUG'LINES, 6-9 
Error Message Logging, 6-1 
Error Messages, File System, 6-33 
Error Recovery, Output Management, 4-19 
Errors, Command, 6-13 
Errors, CS, 6-14 
Examples 

Use of Environment Files, F-2 

MR JET ABL, 4-16 

SUBMIT, 3-19 
EXIT, 3-9 
Exit Procedure, E- 1 

Operation, E- 1 

Installing, E-6 



Failure to Open Output File, Output Management, 4-22 
Failures, 

Local, 6-13 

Operating, 6-13 

Remote, 6-14 
FD Files, 2-2 

Syntax, 2-4 
Features, MRJE/3000, 1-3 
File Contents, Configuration, A-1 
File Contents, Listing Trace File, 5-10 
File Entries, 

Description of Configuration, A- 7 

MRJE/3000 Configuration, Table A-1, A-3 

Summary of Configuration, A-1 
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FILE LISTING Command, 1 - 3 

File Names, SUBMIT, 3-16 

File Naming Convention, Output, Overriding, 2-10 

File Naming, Output, 2- 1 

File Statements, Global, 2-15 

File System Error Messages, 6-33 

filename, trace option, 5-9 

Files 

Building 

Host Console Message Logging, B-5 
MRJE/3000 Configuration, B-4 
MRJE/3000 Stream, B-5 
MRJE/3000 Management, 4-3 
Download, C- 5 
FD Files, 2-2 
Infiles, 2-2 

Job Stream, Relationship, Fig. 2-1, 2-3 
Maintenance of Management, 4-6 
Routing Job Output to Pre -Defined, 2-13 
File, 

Configuration, 1-5, 4-7 
definition of system, G-4 
Directory, 1-6, 4-7 
Form, 4-8 
Job Log, 1-5, 4-7 
Job Stream, 4-8 
Message, 1-6, 4-7 
Message Catalog, 1-6 
Output Management, 1-7, 4-9 
Sample Stream, 5-4 
Stream, 1-6 
Form File, 4-8 
Form ID, definition, G-3 
Format, Console Message, 6-33 
formfile, 3-13 

FORMID Not Found, Error, Output Management, 4-19 
FORMID Specifications, MRJETABL, 4-12 
FORMS, 3-13 

Forms Processing, Special, 2-11 
FORM, MRJECONSOLEh parameter, E-2 
Function Return, MRJECONSOLEh parameter, E-2 



Gathering Information for Problems, 6-15 
General Pseudo Device Information, C-5 
Global File Statements, 2- 1 5 
Glossary, G- 1 
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H 

Hardware, MRJE/3000, 4-1 

HASP command, 3-2, 3-21, 4-24 

HASP System, Configuring a, D-3 

HELP, 3-10 

Hierarchy, Job Output Destination, Figure 2-3, 2-7 

High speed communication line, 1-8 

Host - HP 3000 Carriage Controls, Table 2-1, 2-10 

HOST command, 3-11 

Host Console Commands, 3-21, 4-40 

Host Console Message Logging Facility, 4-41 

Host Console Message Logging Files, Building, B-5 

host ID, definition, G-3 

host number, definition, G-3 

HOST parameter, 3-6 

Host System Job Control, 2-5 

Host System PRIORITY Cards, 2-5 

hostid 

HOST parameter, 3-6 
MRJECONTROL KILL parameter, 5-7 
MRJECONTROL RETRIES parameter, 5-8 
MRJECONTROL SIGNOFF parameter, 5-6 
MRJECONTROL START parameter, 5-3 
MRJECONTROL TRACE parameter, 5-9 
NEW parameter, 4-33 

Host, Configuring the, D- 1 

host, current, definition, G-2 

host, default, definition, G-2 

host, definition, G-3 

HOST, DISPLAY parameter, 4-30 

HP Laser Printer, 2-12, 4-9 

HP2680 Laser Printer, Printing Output on an, F-1 
HP3000, Installing MRJE/3000 on the, B-1 

I 

ID, Form, definition, G-3 

ID, host, definition, G- 3 

image, card, definition, G-2 

Include MRJE/3000, Configuring MPE to, C- 1 

infile, 2-2, 3-13 

Information for Problems, Gathering, 6-15 

Information Messages, MRJE Troubleshooting and, 6-1 

Information, 

Common, 6-15 

Communications Link, 6-16 

display, 3-2, 4-24 

General Pseudo Device, C-5 

MRJE/3000, 6-17 
Initiate transmission, 5-2 
INPandSSLC, C-10, C-20 
Input File Libraries, 2-6 
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Input, Job, 2-1 

Installation, Verifying MRJE/3000, B-6 

Installing an Exit Procedure, E-6 

Installing MRJE/3000, B-1 

instructions, brief, 3-2 

Introducing MRJE/3000, 1-1 

Invalid File Equation, Output Management, 4-21 

item #, ALTER parameter, 4-25 

itemlist, ALTER parameter, 4-25 

itemlist, definition, G-3 

Items, Console Message, 6-33 



JES2 command, 3-2, 3-21, 4-24 

JES2 System, Configuring a, D- 1 

JES3 command, 3-2, 3-21, 4-24 

JES3 or ASP System, Configuring a, D-2 

Job Control, Host System, 2-5 

job entry system commands, 3-21 

Job Input, 2-1 

Job Input Planning, 1-4 

Job Input, SUBMIT, 3-17 

Job Log File, 1-5, 4-7 

job name, definition, G-4 

job number, definition, G-4 

Job Output, 2-7 

Destination Hierarchy, Figure 2-3, 2-7 

Kinds, 2-8 

Planning, 1-4 

SUBMIT, 3-16 

to Pre-Defined Files, Routing, 2-13 
Job Stream File, 4-8 
joblist, 3-3 

CANCEL parameter, 4-27 

definition, G-3 
JOBLOG, 3-6 

DISPLAY parameter, 4-30 
jobname, 3-3 

CANCEL parameter, 4-27 
JOBS, 3-3 

Planning, 2-1 

Submitting, 1-4 
job#, 3-3 

CANCEL parameter, 4-27 
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KILL, MRJECONTROL, 5-7 

Kinds of Job Output, 2-8 



INDEX -7 



Index 



LASER Printers 

and Alternate Character Sets, 4-18 

Output on an, 4-9 

Printing Output on an HP2680, F-1 
LENGTH, MRJECONSOLEh parameter, E-2 
Libraries, Input File, 2-6 
Limitation, MRJETABL, 4-18 
Line 

Monitors, Pseudo, C-2 

Printers and Punches, Pseudo, C-3 

communication, high speed, 1-8 

Opening a Communications, 5-4 
Link, BSC, 4-2 
Link, Communications, 6-16 
Listing Trace File Contents, 5-10 
LISTING, FILE, 1-3 
Local Failures, 6-13 

Logging Facility, Host Console Message, 4-41 
Logging Files, Building Host Console Message, B-5 
Logging, Error Message, 6-1 



M 

Management Files 

Building for MRJE/3000, 4-3 

Files, Maintenance of, 4-6 
Management Special Capabilities, 4-1 
Management, Output, 4-11 
Manager Commands, 4-24 
Manager Session, Typical, 4-38 
Manager, capitalized, definition, G-4 
Managing MR JE/ 3 0, 4 - 1 
mask, trace option, 5-9 
Measurement, Performance, 4-41 
Message Catalog File, 1 -6, 6-46 
Message File, 1-6, 4-7 

Output Routing to, 2- 1 2 
Message Format, Console, 6-33 
Message Items, Console, 6-33 
Message Logging Facility, Host Console, 4-41 

Files, Building Host Console, B-5 

Error, 6-1 
Messages 

Sent to System Console, MRJE/3000, 6-33, 6-35 

File System Error, 6-33 

MRJE Troubleshooting and Information, 6-1, 6-14, 6-1 

MRJECONTROL Console, Table 6-2, 6-31 
Method of Output on an HP2680 Laser Printer, F-1 
Modems, 4-2 

Monitors, Pseudo Line, C-2 
MPE Command, 3-23 
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MPE I/O, MRJE/3000 Configured into, Figure C-1, C-6 
MPE to Include MRJE/3000, Configuring, C-1 
MRJE/3000 

Commands: See Commands. 
Configuration File Entires, Table A-1, A- 3 

Building, B-4 
Configured into MPE I/O, Figure C-1, C-6 
Console Operator, definition, G-2 

Designating, 5-1 
Features, 1-3 
Hardware, 4- 1 
Information, 6-17 
Installing, B- 1 
Installation, Verifying, B-6 
Management Files, 1-4 

Building, 4-3 
Manager 

Commands Summary, Table 4-1, 4-24 
definition, G-4 
Message Catalog, 6-46 
Messages, 6-14 

Messages Sent to the Console, Table 6-3, 6-35, 6-33 
Operation with MRJETABL, 4-14 
Pseudo Device Configuration Dialog, C- 14 
Software, 4-2 
Stream Files, Building, B- 5 
Troubleshooting and Information Messages, 6-1 
User 

Commands, 3-1 
definition of, G-4 
Messages, Table 6-1, 6-18 
definition, G-4 
MRJECAT.PUB.SYS, 1-6 
MRJECONSOLEh Procedure, E-2 
MRJECONTROL CHECK, 5-11 
MRJECONTROL 
Commands, 5-2 

Console Messages, Table 6-2, 6-31 
KILL, 5-7 

RSCS Exception, 5-7 
RETRIES, 5-8 
SIGNOFF, 5-6 

RSCS Restriction, 5-6 
START, 5-3 
TRACE, 5-9 
VERIFY, 5-12 
MRJECON/z.PUB.SYS, 1-5 
MRJEDIR;i.PUB.SYS, 1-6 
MRJEJOBft.PUB.SYS, 1-5 
MRJEMSG/i, 1-6 
MR JESTRMft. PUB. SYS, 1 - 6 
MRJETABL, 1-7 
Examples, 4-16 
Considerations for Building, 4- 1 1 
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File Equation use with, 4-12 
Record Specifications, 4-12 
FORMID Specifications, 4-12 
Limitation, 4- 1 8 
Operation with, 4- 1 4 
Verifying the Contents of, 4-23 

N 

name, job, definition, G-4 
Naming, Output File, 2-10 

Overriding, 2-10 
NEW, 4-33 

NOTRANSLATE, 3-13 
number, host, definition, G-3 
number, job, definition, G-4 
numentires, trace option, 5-9 



OFF, MRJECONTROL TRACE parameter, 5-9 
OLDJOBS, 

DISPLAY parameter, 4-30 

PURGE parameter, 4-36 
ON, MRJECONTROL TRACE parameter, 5-9 
Open communications link, 5-2 
Opening a Communcations Line, 5-4 
Operating Failures, 6-13 
Operation, Exit Procedure, E-1 
Operator, Console, Designating, 5-1 
Organization, viii 
Output 

Causes of Unsolicited, 4-42 

Control of Unsolicited, 4-43 

Destination Hierarchy, Job Output, Fig. 2-3, 2-7 

Device Routing, Unsolicited, 2-14 

File Naming, 2- 1 

Job, 2-7 

Management, 4-1 1 

Management File, 1-7, 4-9 

Management, Error Recovery, 4-19 

Management, Routing Output with, 2-11 

on an HP Laser Printer, 4-9 

on an HP2680 Laser Printer, Printing, F-1 

Pre -Defined Files, Routing Job, 2-13 

Routing to Message Files, 2-12 

Routing with Output Management, 2-11 

Spoolfiles, Segmenting, 4-9 

to Unsolicited Devices, Routing Default, 2-13 
Overriding the Output File Naming Convention, 2-10 
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parse host console setup messages, E-2 

Performance Measurement, 4-41 

Planning Job Input and Output, 1-4, 2-1 

Pre-Defined Files, Routing Job Output to, 2- 1 3 

PRINT, 3-13 

Printers, Pseudo Line, C-3 

Printer, Printing Output on an HP2680 Laser, F-1 

printf ile, 3-13 

Printing on an HP Laser Printer, 2-12 

Printing Output on an HP2680 Laser Printer, F- 1 

PRIORITY cards. Host system, 2-5 

Problems, Gathering Information for, 6-15 

Procedure Operation, Exit, E- 1 

Installing, E-6 
Procedure, MRJECONSOLEh, E-2 
Processing, Special Forms, 2-11 
Pseudo Card Punches, C-4 
Pseudo Card Readers, C-4 
Pseudo Console, C-2 
Pseudo Device, 4-2 

Configuration Dialog, MRJE/3000, C- 1 4 
Information, General, C- 5 
Line Monitors, C-2 
Line Printers, C-3 
pseudo reader, 3-13 
PUNCH, 3-13 
Punches, Pseudo Card, C-4 
punchfile, 3-13 
PURGE, 4-36 
Purge entries from Job Log File, 4-24 



Q 



READER, 3-13 

Readers, Pseudo Card, C-4 

Rebuild Configuration File, 4-24 

Receiving Output, Transmitting Jobs and, 1-4 

Record Sizes, Job Output, 2-7 

Record Specifications, MRJETABL, 4- 1 2 

RECORD, MRJECONSOLEh parameter, E-2 

Related Documents, ix 

Relationship Among Files in a Job Stream, Fig. 2-1,2-3 

Remote Failures, 6-14 

REPLY, MRJECONSOLEh parameter, E-2 

Requirements, Configuration, C-1 

RETRIES, MRJECONTROL, 5-8 

Return control to MPE, 3-2 
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Routing 

Default Output to Unsolicited Devices, 2-13 
Job Output to Pre -Defined Files, 2-13 
to Message Files, Output, 2-12 
with Output Management, Output, 2- 1 1 
Unsolicited Output Device, 2-14 
RSCS 

command, 3-2, 3-21, 4-24 
Exception, MRJECONTROL KILL, 5-5 
Restriction, MRJECONTROL SIGNOFF, 5-6 
System, Configuring an, D-5 
Running MRJE, 1 - 3 



Sample Stream File, 5-4 

Segmenting Output Spoolfiles, 4-9 

Session, Typical MRJE/3000 Manager, 4-38 

Set retransmission limit, 5-2 

Several Subsystems, Configuring an INP or SSLC, C-20 

SIGNOFF, MRJECONTROL, 5-6 

Software version check, 5-2 

Software, MRJE/3000, 4-2 

Special Capabilities, Management, 4- 1 

Special Forms Processing, 2-11 

Specify host, 3-2 

Spoolfiles, Segmenting Output, 4-9 

SSLC 

Configuration Summary, INP and, Table C-1, C-20 
Dialog for an INP or, C- 1 
START, MRJECONTROL, 5-3 
STATUS, 3-6 

STATUS, DISPLAY parameter, 4-30 
Stream File, 1-6 

Building MRJE/3000, B-5 

Sample, 5-4 
SUBMIT, 3-12 
Submitting Jobs, 1-4 

Subsystems, Configuring an INP or SSLC for, C-20 
Summary 

Configuration File Entries^ A-1 

INP and SSLC Configuration, Table C-1, C-20 

MRJE/3000 Manager Commands, Table 4-1, 4-24 

MRJE/3000 User Commands, Table 3-1,3-2 
Syntax, FD Files, 2-4 

System Console, MRJE/3000 Messages Sent to, 6-33 
System Error Messages, File, 6-33 
system file, definition, G-4 
System, Configuring 

ASP, D-2 

HASP, D- 3 

JES2,D-1 

JES3,D-2 

RSCS, D-5 
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Terminate MRJE/3000, 3-2 
trace 

File Contents , Listing ,5-10 

function, MRJECONTROL START parameter, 5-3 
options, MRJECONTROL TRACE parameter, 5-9 
ALL, 5-9 
filename, 5-9 
mask, 5-9 
numentries, 5-9 
WRAP, 5-9 
MRJECONTROL, 5-9 
Translation 

Carriage Control , 2-9 
EBDCDIC to ASCII, 2-10 
Transmitting Jobs and Receiving Output, 1-4 
TRANSPARENT, 3-13 
Troubleshooting and Information Messages, MRJE, 6-1 
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Unsolicited 

Devices, Routing Default Output to, 2-13 

Output Device Routing, 2-14 

Output, Causes of, 4-42 
Controlling, 4-43 
User 

Commands, 3-1 

in Upper case, definition, G-4 

in lower case, definition G-4 

Messages, MRJE/3000, Table 6-1,6-18 
Using a File Equation with MRJETABL, 4-12 



Validate MRJETABL entries, 5-2 
Verifying MRJE/3000 Installation, B-6 

Contents of MRJETABL, 4-23 
VERIFY, MRJECONTROL, 5-12 
Version check for software, 5-2 
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WORK_AREA, MRJECONSOLEh parameter, E-2 
WRAP, trace option, 5-9 
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